On this page
- Overview
- Where it works
- Installation
- Choosing the blog
- Contained Cards
- Editorial Grid
- Switching layouts
- Filters: categories and authors
- Search and its requirements
- Navigation and pagination
- Images, excerpts and card details
- Fonts, colors and spacing (Styles tab)
- Responsive behavior
- Accessibility
- Known limitations
- Troubleshooting
- Support
A HubSpot CMS module by Avanzia Consulting SRL. This guide explains where the module works, how to add it, how to choose a layout and a blog, how filters, search and pagination behave, how to customize the look, and what it does not do.
Overview
Blog Listing Duo shows the posts of a HubSpot blog in one of two layouts that you choose in the module settings:
- Contained Cards: bordered cards with a 16:9 image, an outlined category label with a dot, title, excerpt, author and reading time, below a full-width filter bar.
- Editorial Grid: open cards with large rounded images, up to two category tags over the image, editorial titles, excerpt and details, below a heading and a filter row.
Both layouts include category and author filters, a search box, and previous and next buttons. Everything is edited in the HubSpot editor, with no code. The module uses one very small script (under 0.5 KB) and no external library.
Where it works
Blog Listing Duo can show posts in two ways, chosen in Layout > Posts come from:
- The blog of this page: for HubSpot blog listing templates (the blog listing page, tag pages and author pages). The module reads the list of posts that HubSpot gives to those templates. Filters, post count and previous / next buttons work only in this mode.
- A blog I choose: works on any website page or landing page. It shows the latest posts (1 to 24) of the blog you pick. In this mode there is no post count and no previous / next buttons; the filters are still links to that blog's own tag and author pages.
You need a HubSpot blog with published posts. The module was tested in current Google Chrome (desktop and mobile emulation) on a HubSpot blog listing with 14 posts, 10 per page. Other browsers, other themes and multi-language blogs were not part of the tests.
Installation
Blog Listing Duo will be distributed through the HubSpot Marketplace; the link to its listing will be published on this page when HubSpot makes it public.
After you install it:
- To list the posts of your blog, open the blog listing template your blog uses in the Design Manager (or ask your developer) and add the module where the list should appear. In a drag and drop template, drag Blog Listing Duo into the layout.
- To show a blog on a normal page instead, add the module in the page editor and choose A blog I choose.
- Open the page in the editor, select the module and edit its settings.
- Set the number of posts per page in Settings > Website > Blog. The module follows that number.
Choosing the blog
In the Layout group, Posts come from decides the source. With The blog of this page nothing else is needed. With A blog I choose, pick the blog and the number of posts. If the module is placed on a page that has no blog and the first option is selected, the editor shows a short notice instead of posts.
Contained Cards
A full-width bar holds the search box, the category filter, the author filter and the post count. Below it, the cards show a 16:9 image (a neutral placeholder if the post has no featured image), the first category of the post, the title, an excerpt, and the author with photo or initial and the reading time. Cards lift slightly when hovered. The excerpt comes from the post's meta description, then from its summary.
Settings specific to this layout: post count text, corner radius, gap between cards, content width, post title size, font, and the section, border, accent, tag, title, excerpt and detail colors.
Editorial Grid
A large heading (editable, or empty to hide it) sits above a row with the category filter, the author filter and the search box with its button. Cards have no outer border: a 16:10 image with rounded corners carries up to two category tags, followed by the title, an excerpt (three lines at most), a divider, the reading time and the author. The excerpt comes from the post summary, then from the meta description. An optional Keep reading button can be turned on; it is off by default.
Titles and the heading follow your theme's heading font unless you choose Choose a font in the Typography group. Body text follows your theme.
Switching layouts
Change Layout in the module settings. The blog, the number of posts, the columns and the shared settings stay as they are. Fields that belong to one layout (for example the post count text or the heading) appear only for that layout, and the values you set stay saved when you switch and come back.
Filters: categories and authors
The category and author filters are dropdowns. Choosing an option opens that tag page or author page of your blog (for example /blog/tag/design), which uses the same listing template, so the page reloads with those posts. They are the blog's own addresses: they can be shared, bookmarked and used with the back button. The current category or author is shown in the dropdown.
A filter is shown only when it can work: the category filter needs at least one tag and the author filter at least one author in the blog (the first 100 of each are listed). Each filter can also be turned off. If JavaScript is not available, a plain list of links replaces the dropdowns.
Filters do not filter instantly on the same page. This is intentional: the module never downloads other pages of your blog to filter them, so it stays fast with any number of posts.
Search and its requirements
The search box sends the visitor to your HubSpot site search results page, limited to the posts of this blog. By default the address is /hs-search-results (Advanced > Search results page). That page must exist on your site and should list blog posts. Search does not filter the cards on the current page.
Navigation and pagination
When the blog has more posts than fit on one page and the posts come from the blog of the page, Previous and Next buttons appear below the cards and open the blog's own page 2, 3 and so on. They can be turned off and their texts edited. There are no numbered pages and no "load more" button, and the module does not load further posts without leaving the page.
Images, excerpts and card details
In the Cards group you can show or hide the featured image, the category tag(s), the excerpt (and its length in characters), the author, the author photo, the reading time (and its text), the optional button and the text shown when there are no posts. Reading time is estimated from the word count of the post at the reading speed set in Advanced (220 words per minute by default). Images are cropped to fit the shape of the layout; set a good featured image on each post. Author photos come from the HubSpot blog author profile.
Fonts, colors and spacing (Styles tab)
The Styles tab has three groups. Typography: font and post title size for Contained Cards; title font source (theme or a chosen font) and post title size for Editorial Grid. Colors: section background, borders, accent, tag, title, excerpt and detail colors for each layout; the accent follows your theme's primary color unless you change it. Spacing: content width, and gap and corner radius for Contained Cards or image corner radius for Editorial Grid. The default values reproduce the two original designs.
Responsive behavior
You choose 2, 3 or 4 columns for large screens. Contained Cards uses two columns below 1050 px and one below 760 px, where the filter bar stacks. Editorial Grid uses two columns below 1024 px and one below 680 px, where the filters stack. The page never scrolls sideways; long titles wrap inside their card.
Accessibility
Each post is an article with one link (its title), so keyboard and screen reader users meet one link per post. Dropdowns and the search box have labels, the search is a landmark, and previous / next buttons are in a labelled navigation. Focused cards and controls show a visible outline. Decorative images are hidden from assistive technology. Transitions are turned off when the visitor prefers reduced motion. The module was not tested with a screen reader. If you change colors, check the contrast of your own choices.
Known limitations
- Filters and pagination reload the page; there is no instant filtering.
- With The blog of this page the module works only in blog listing templates. With A blog I choose it works anywhere but has no count and no pagination.
- Search opens your site's search results page; it does not filter the visible cards.
- Up to 100 categories and 100 authors are listed in the dropdowns.
- The two layouts are fixed designs with editable colors, fonts and spacing; they are not a page builder.
- The Contained Cards layout shows the author's photo or a Gravatar image when HubSpot has one, otherwise the initial; the Editorial Grid shows the photo only when the HubSpot author has one.
Troubleshooting
- I see a notice about a missing blog in the editor: the page is not a blog listing page. Place the module in a blog listing template or choose A blog I choose.
- No filters appear: the blog has no tags or authors yet, or the filter is turned off. HubSpot can take a few minutes to update tags after a post is published.
- The list shows "No posts to show yet": the blog has no published posts.
- The search shows nothing useful: check that your site has a search results page and that the address in Advanced matches it.
- The number of posts per page is wrong: it comes from your blog settings, not from the module.
- The fonts or colors differ from the preview: the module follows your theme's fonts and primary color unless you change them in the Styles tab.
- My theme changes the look: styles are scoped to the module, but a theme that forces rules with !important on lists, headings or links can override them.
Support
Avanzia Consulting SRL handles reports of errors in this module, that is, cases where it does not work as described in this guide, in line with the obligations that apply to Marketplace listings. Write to hola@weareavanzia.com and include the page address, your browser, the steps to reproduce the problem and, if possible, a screenshot.
Support does not include custom changes or personalization of the module, setup work on your site, or general support. No response times are guaranteed, and no future features are promised.
Last updated: November 18, 2026.