Skip to content

Edit blog listing pages

Last updated: October 17, 2025

Available with any of the following subscriptions, except where noted:

A blog listing page is a page that displays all a blog's posts. In HubSpot, some blog listing pages can be edited with drag and drop tools in the content editor, while others require HTML + HubL editing in the design manager (Marketing Hub Professional or Enterprise or Content Hub Professional or Enterprise only).

Please note: you can only delete a drag and drop listing page by deleting its associated blog

Create and edit drag and drop listing pages

In the content editor, you can create a blog listing page that displays all your blog's posts. Only listing pages that use themes or have drag and drop areas support adding or moving modules in the content editor. 

Opt an existing blog listing page into editing in the content editor

Newly created blogs will automatically support editing in the content editor for their blog listing pages. For older blogs, you can opt into this editing experience in blog settings: 

  1. In your HubSpot account, click the settings settings icon in the top navigation bar.
  2. In the left sidebar menu, navigate to Content > Blog
  3. Click the Current view dropdown menu and select a blog
  4. Click the Templates tab. 
  5. In the Templates section, click Try new editing experience. 
In the blog settings, the templates tab is displayed. In the templates section, an arrow is pointing to the Try new editing experience.
  1. In the dialog box, click Continue
  2. In the content editor, use the drag and drop editing tools to edit the blog listing page. 
  3. When finished, click Update in the top right, then click Update in the dialog box. 

Edit blog listing page in the content editor

Blog listing pages that are opted into editing in the content editor can be accessed from the Blog posts page.

  1. In your HubSpot account, navigate to Content > Blog.
  2. In the top left, click the Configure dropdown menu and select Blog listing pages
On the Blog posts page, there's an arrow pointing to the configure dropdown menu and the options are displayed on the right. A box is placed around the blog listing pages option.
  1. To filter by blog, click the Blog dropdown menu and select the checkbox next to each blog you want to include in your filter.
  2. To create a new blog listing page, click Create in the top right. In the dialog box, click the Select a blog dropdown menu and select a blog, then click Create listing page

Please note: each blog can only have one blog listing page. If a blog already has a blog listing page, you will not be able to create a new one for that blog. 

  1. To edit an existing blog listing page, click the name of a listing page. To access multi-language blog listing pages, click the downCarat down arrow next to the primary blog listing page. 
  2. In the content editor, use the drag and drop editing tools to edit the blog listing page. 
  3. The modules that appear will vary depending on your template. Some common modules include: 
    • Blog tag filter: filter your blog posts by tag. 
    • Blog pagination: set the text that moves visitors between different pages of your blog. 
    • Blog listings: set Card or List as the style of your blog descriptions and select the information that'll display there. You can also edit the subheadings of author and tag listing pages. 
In the content editor for a blog listing page, the contents are displayed showing some common modules that are included (e.g., Blog tag filter, Blog listings, Blog pagination).
  1. To edit the listing page's settings, click Settings in the top right.
  2. Then edit the listing page's settings in the dialog box: 
    • To change how the page is named in HubSpot, enter a page name in the Internal page name field. This name will not appear to visitors. 
    • The public-facing name of the blog will appear in the Page title field. You can change this name in the Page title field in your blog settings. 
    • The URL of your listing page will appear in the Page URL field. You can change this name in the Blog root URL field in your blog settings. 
    • In the Meta description field, enter a description of the listing page's content that'll appear in search results below the page title.
    • To add a featured image to your listing page for social sharing, click Featured image in the left sidebar menu. Then toggle the Enabled featured image switch on and click Upload to add an image from your browser or Browse images to add an image from the files tool
    • To add additional code to the listing page's head or footer HTML, click Advanced in the left sidebar menu. In the Head HTML or Footer HTML field, enter your code snippet
  3. When finished, click Publish or Update in the top right.

Change listing page templates

  1. In your HubSpot account, navigate to Content > Blog.
  2. In the top left, click the Configure dropdown menu and select Blog listing pages.

On the Blog posts page, there's an arrow pointing to the configure dropdown menu and the options are displayed on the right. A box is placed around the blog listing pages option.

  1. Click the name of a listing page. To access multi-language blog listing pages, click the downCarat down arrow next to the primary blog listing page. 
  2. In the content editor, click Settings in the top right.
  3. In the left sidebar menu, click Template.
  4. In the Template section, click Use different template
  5. On the Choose a template page, click a template card. To change the theme, click the Theme dropdown menu and select Change theme then click a template card.
  6. On the template preview screen, click Select template in the top right. 
  7. In the content editor, make any changes to the template.
  8. When finished, click Publish or Update in the top right.

Edit coded blog listing page templates 

You can create coded blog listing page templates that use HTML/HubL markup. Some listing page templates will also support editing modules in the layout editor, while others will be entirely coded. 

A Marketing Hub Professional or Enterprise or Content Hub Professional or Enterprise subscription is required to edit coded blog listing page templates.

  1. In your HubSpot account, click the settings settings icon in the top navigation bar.
  2. In the left sidebar menu, navigate to Content > Blog.
  3. Click the Current view dropdown menu and select a blog.
  4. Click the Templates tab.
  5. In the Blog Listing Page section, click the Actions dropdown menu and select Edit.
  6. In the layout editor of the design manager, click a module and edit its options in the inspector.
  7. To edit the blog content module for the listing template, click the Blog content module, then click Edit listing template in the right column. 
In the design manager, a blog template is displayed in the layout editor. An arrow points to the Blog Content module in the layout editor. A box is placed around the Edit listing template button in the inspector on the right.
  1. In the module editor, customize your listing template. Learn more about using HubL to edit a blog listing template in our developer documentation. 
  2. When finished, click Publish changes in the top right to take your changes live.
Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.