Blog Listing Templates

Last updated:

Blog listing templates typically display summary information for the posts within the blog. They are a jumping off point to access the blog posts. They typically sequentially list blog posts based on the date they were published, and display the featured image and title of the post.

Blog listing templates have the template annotation:

HTML
templateType: blog_listing

This templateType makes the template available for selection under blog settings specifically for the listing view. Making it easy for content creators to select. The blog_listing templateType also supports editing the listing page in the page editor.

The page editor experience for blog listing editing is currently in beta. This beta is automatically available for all new accounts. The beta is rolling out slowly to existing accounts. You do not need to request access.

Content creators can edit the content of the page similar to standard CMS pages. This means module fields can be changed. If a dnd_area, or flexible column is present in the template. The content creator can change the layout of modules as well as add and remove modules from the listing page.

Modules, dnd_areas and flexible columns all work like they would for a CMS page.

When changes to this page are published by the content creator they will apply to all uses of this listing template, including paginated pages and tags.

This functionality does not make hard coded strings suddenly editable. It does however make it so that using modules and drag and drop areas can make for a flexible blog listing.

The HubSpot boilerplate blog templates include dnd_areas and can be used as inspiration.

Build the blog loop as a module

Because content creators may want to place modules to the side of a blog listing, or above or below it. Creating a blog listing module can be quite handy. Your blog listing module does the same blog loop you are used to, just inside of a module. This enables content creators to move or re-layout the blog listing. Additionally you can provide options for changing how the listing displays.

An example blog listing module can be found in the HubSpot boilerplate.

Additionally we recommend building into your module features like "show summaries" and "use featured image". These are currently settings in the blog settings but it is a better editing experience to see them inline.

Tip: It is recommended you make all text strings on your blog listing template controlled by fields. This makes it easier to create multilingual blogs later on, in-addition to giving content creators more control.

Convert blog templates to blog listing templates

If you have a template using the blog templateType you can migrate at any time to a blog_listing or blog_post template.

Migrate to single purpose blog template


Was this page helpful? *
This form is for feedback on our developer docs. If you have feedback on the HubSpot product, please share it in our Idea Forum instead.