Blog Post

The template every blog post uses. It renders the post’s title, a meta line, the excerpt, the featured image, then the post body.

This is the only section on the article template, so editing it changes every post at once. There is no per-post layout switch.

Layout

Everything sits in one centred column that caps at 1080px on large screens, so lines stay a comfortable reading length no matter how wide the browser is.

The order is set by the blocks, top to bottom:

1. Title — the post title, date/read time, and excerpt
2. Featured image — the post’s image, full column width
3. Content — the post body

You can reorder or remove any of them in the theme editor. Removing the Content block hides the post body, so it’s rarely what you want.

Blocks

Title

Setting	What it does
Date	Shows the published date. On by default.
Read time	Shows an estimated read time. On by default.
Author	Shows the post author. Off by default.
Excerpt	Shows the post excerpt below the date line. On by default.

The date, author, and read time share one line, separated by vertical bars. Turn any of them off and the bars adjust — you won’t get a stray separator.

Read time is calculated, not typed

It’s worked out from the post’s length at 200 words per minute, rounded down, with a one-minute minimum. There’s nothing to fill in, and it updates by itself when you edit the post. A very short post always reads “1 min read.”

The excerpt has to exist on the post

The Excerpt setting shows the post’s own excerpt field, set in Shopify admin under the post’s content. If the post has no excerpt, nothing renders and the spacing closes up — the setting can’t invent one.

Featured image

Setting	What it does
Aspect ratio	The shape of the image: 16:9 (default), 3:2, 2:1, or 1:1

Uses the post’s featured image, set in Shopify admin. If the post has no image, the block renders nothing rather than leaving a gap.

The image is cropped to fill the chosen ratio, so the centre of the image is what survives. Pick the ratio that suits the images you actually publish rather than switching it per post — the setting applies to every post.

Content

The post body. No settings.

A heading at the very top of the body is removed

Older posts were written with the post title repeated as a heading at the top of the body. Because the section already prints the title above, that duplicate is stripped automatically. If you deliberately start a post with a large heading, it will disappear — start with a subheading instead.

Section settings

Setting	What it does
Section ID	An optional anchor id, for linking to this section directly
Show “Back to blog” link	Shows the back link under the post. On by default.
AI SEO → Tag	The tag that opts a post into the AI SEO layout. Defaults to aiseo-layout.
AI SEO → Quick links menu	A navigation menu shown in the sidebar. Leave empty to hide that box.

AI SEO posts

Some posts are written in a longer, more structured format — with a “quick answer” panel and an “at a glance” summary in the body. Those posts are marked with the aiseo-layout tag in Shopify, and they get a different treatment:

• A sidebar on the left, from large screens up, holding a table of contents and an optional quick links menu
• Callout styling for the quick-answer and at-a-glance boxes in the body

The post heading — title, date, excerpt — spans the full width above the sidebar. Everything else lines up with the article text.

Table of contents

Built automatically from the H2 and H3 headings in the post. There’s nothing to configure and nothing to keep in sync — edit a heading and the list follows.

It highlights the section you’re currently reading as you scroll, and clicking an entry jumps to that section.

On phones the sidebar moves above the article and the contents list collapses behind a tap-to-open heading, so it never buries the opening paragraph.

A post with no headings shows no contents box

The box hides itself rather than rendering empty. If a tagged post should have a table of contents, add H2 headings to it.

Quick links

Pick any navigation menu in the Quick links menu setting and it renders in the sidebar below the contents. Leave it empty and the box doesn’t appear.

Because it’s a normal menu, it’s edited in Navigation in Shopify admin — the same place as the header and footer menus.

Removing the tag removes the whole treatment

The callout markup lives in the post body, not in the theme. Untag a post and the sidebar disappears and those boxes lose their background and padding — they’ll read as ordinary paragraphs. Nothing errors; it just looks plainer. Re-adding the tag restores it.

Only change the Tag setting if the tag was renamed

The Tag setting exists so the theme can follow the tag if it’s ever renamed in Shopify. Changing it to a tag no posts use silently switches every post back to the plain treatment.

The tag is visible to shoppers unless you hide it

aiseo-layout is an ordinary article tag, so it can show up in tag lists and filters alongside editorial tags. It’s a layout switch, not a topic — worth keeping out of any place tags are displayed to shoppers.

Adding a callout to a post

In the post’s HTML, wrap the content in a div with the matching class:

<div class="aiseo-quick-answer">
  <h3>Quick answer</h3>
  <p>The short version, up front.</p>
</div>

Use aiseo-at-glance for the summary variant, and aiseo-disclaimer on a paragraph that should read as fine print. The post must carry the tag for any of these to take effect.

Tips

• One H1 per post. The section prints the title as the page’s only H1. Use H2 for sections within the body and H3 beneath those — don’t skip levels.
• Tables scroll rather than overflow. Ingredient panels and comparison tables in a post body stay inside the column on phones.
• Images in the body are responsive. Older posts have fixed image widths written into them; the theme overrides those so nothing overflows on mobile.