How to Set Up the Blog Category Template in Maison

Show date: Enabled

25. Customize Blog cards globally

Maison provides additional global styling under:

Theme settings > Blog cards

Available Card styles are:

• Normal
• Card

You can also configure:

Border

• Border thickness: 0–12px
• Border opacity: 0–100%
• Border radius: 0–50px

Shadow

• Shadow opacity: 0–100%
• Horizontal offset: -12px to 12px
• Vertical offset: -12px to 12px
• Blur: 0–60px

26. Configure Blog category section colors

Enable Color override when the Blog category post area should use custom colors.

Available controls include:

• Text color
• Background color
• Background gradient
• Button text color
• Button background color
• Button gradient

If Color override is disabled, the section follows the theme's standard colors.

27. Configure Section width and spacing

Available Section width options are:

• Narrow
• Page
• Fluid
• Full

Default:

Page

The Blog category section also includes:

• Section divider
• Layout
• Spacing

Default section spacing is:

Desktop:
80px top
80px bottom

Mobile:
40px top
40px bottom

The default Maison Blog category template changes the desktop vertical spacing to approximately:

60px

Default Maison Blog category template

The current Maison template follows this structure:

Blog category banner
├── Breadcrumb
├── Title
└── Tag filter

Blog category
└── Blog card
    ├── Blog info
    │   ├── Title
    │   ├── Author date — Disabled
    │   ├── Summary
    │   └── View more
    └── Cover image
        ├── Aspect ratio: 16:9
        └── Show date: Enabled

Main Blog category settings:

Blog section vs. Blog category template

These two Maison features serve different purposes:

How the Blog category template works

Customer opens a Blog category
│
├── Blog category banner
│   ├── Show Breadcrumb
│   ├── Show current Blog title
│   └── Read available post tags
│       └── Generate Tag filter
│
└── Blog category
    ├── Load posts from current category
    ├── Apply active tag filter
    ├── Apply Blogs per page
    ├── Render each post using Blog card
    └── Generate Pagination when required

Recommended setup

For a clean Maison-style Blog category page:

• Keep the Blog category banner Title enabled.
• Use Tag filter when your posts have useful content categories.
• Use 2 desktop Columns for an editorial layout.
• Use 1 Mobile column for larger and easier-to-read Blog cards.
• Use consistent Cover image ratios.
• Use Maximum rows on Title and Summary if card heights vary too much.
• Enable Author date only when author/date metadata is useful.
• Keep Blogs per page at a reasonable value to avoid overly long category pages.
• Test tag filtering and pagination after publishing new posts.

Notes and limitations

Please note the following behavior:

• Blog category banner and Blog category are separate sections in the default template.
• The Banner Title automatically displays the current Blog category title.
• Tag filter options are generated from tags used by posts in the current Blog category.
• Tag filter is hidden when no tags are available.
• Desktop Tag filter uses links.
• Mobile Tag filter uses a dropdown.
• Blog category posts are loaded automatically from the current category.
• Blogs per page supports 2–50 posts.
• Desktop Columns supports 1–3.
• Mobile columns supports 1–2.
• Pagination is generated automatically when required.
• One Blog card structure is reused for all posts.
• Blog card supports one Cover image and one Blog info block.
• Blog info supports one Title, Author date, Summary, and View more block each.
• Cover image and Blog Title link to the post page.
• Blog card border and shadow settings are controlled globally under Theme settings > Blog cards.

Troubleshooting

If the Blog category template does not display correctly, check the following:

• Make sure the Blog category contains published posts.
• If Tag filter is missing, make sure the posts contain tags.
• If a tag is missing from the filter, check whether at least one post in the current Blog category uses that tag.
• If the wrong posts appear after selecting a tag, check the tags assigned to those posts.
• If fewer posts appear than expected, check Blogs per page and Pagination.
• If Pagination does not appear, make sure the total number of posts exceeds Blogs per page.
• If the desktop grid has the wrong number of cards per row, check Columns.
• If mobile cards are too small or too large, check Mobile columns.
• If Cover images crop incorrectly, adjust the Cover image Aspect ratio or Image fit.
• If the Cover date is missing, enable Show date.
• If Author date is missing, make sure the block is enabled and Show author / Show date are turned on.
• If Summary is empty, check that the blog post has excerpt data.
• If View more disappears on mobile, check Hide on mobile.
• If Blog card border or shadow looks unexpected, check Theme settings > Blog cards.
• Save your changes and test the category page, tag filtering, and Pagination on both desktop and mobile.

Need Further Assistance

If you encounter any issues or need additional help with your Maison theme, please reach out to our support team via our Ticket System for assistance within 8 hours.