FAQs

A centred column of expandable question-and-answer rows, each with a plus/minus toggle (kale-coloured minus, opacity crossfade). The questions come from a metaobject FAQ cluster — the same cluster can be maintained once and shown on several pages — or from manual FAQ Item blocks when no cluster is attached.

FAQPage structured data (JSON-LD) is emitted automatically whenever a cluster is connected, which is what lets Google show the questions in search results and AI assistants quote the answers. There’s nothing to turn on.

Settings

Setting	What it does
Section ID	Optional anchor for jump links. Must be unique on the page, in handle format.
FAQ cluster	A faq_group metaobject. Connect via dynamic source to pull per-product or per-collection FAQs. Leave empty to fall back to FAQ Item blocks.
Padding top / bottom (mobile)	Space above and below the section on phones. Default 48px each.
Padding top / bottom (tablet)	Default 64px each.
Padding top / bottom (desktop)	Default 80px each.

There are no colour or background settings — the section inherits its text colour from the page.

Blocks

Static blocks:

• Title — the heading above the questions. Clear its text to run the section with no heading at all.

The cluster’s own title is not used here

A cluster is reused across pages, so a title travelling with it would change out from under the page it was placed on. Set the heading where you can see it — on the Title block inside the section.

Repeatable:

• FAQ Item — question, rich text answer, and an “open by default” toggle. Only renders when no cluster is attached.

Blocks are silently ignored once a cluster is attached

The moment a cluster with questions is selected, every FAQ Item block stops rendering. The blocks stay in the sidebar looking editable, so it’s easy to spend time editing questions that aren’t on the page. If your edits aren’t appearing, check whether FAQ cluster is filled in.

An empty cluster — one with no questions — falls back to the blocks as normal.

Auto-hide on PDP and collection pages

On product and collection pages, the section hides entirely when no metaobject cluster is connected — no heading, no empty box, no spacing. The page closes up as if the section weren’t there. This means you can add FAQs to the product or collection template once and it only appears for resources that have a cluster assigned via nama.faq_cluster.

On other page types (homepage, custom pages) the section always renders, even if empty.

Tips

• Use a cluster for anything repeated. Shipping, returns and care questions that belong on more than one page should live in a cluster, maintained once.
• Write answers as complete sentences. They’re pulled into structured data stripped of formatting — an answer that only makes sense next to the question reads badly out of context.
• Leave every row closed. Opening one by default pushes everything below it down the page. Use Open by default only for single-question sections.
• Order by frequency, not by topic. Most visitors read the first two or three and stop.
• Keep it to eight questions or fewer. A long accordion is a wall of near-identical rows. Split across two sections with their own headings if you have more.