FAQ Page Accordion

What this section does

The FAQ accordion section powers the main FAQ experience on the FAQ page. It supports:

1. Section heading and intro text.
2. Optional category tabs.
3. Expand/collapse question rows with rich text answers.

Where it appears

1. Template: FAQ (page.faq).
2. Section instance in template: faq.
3. Section type: faq-accordion.
4. Block type: FAQ.

How to set it up

1. Go to Online Store -> Themes.
2. Click Customize.
3. Open the FAQ template/page.
4. Select FAQ accordion in the left sidebar.
5. Configure section settings and FAQ blocks, then save.

Key section settings explained

1. Heading: main title.
2. Text: intro paragraph under the title.
3. Show category tabs: enables/disables the tab bar.
4. Tabs label: accessibility label for the tablist.
5. Default tab: first tab shown on page load (must match an existing tab label).
6. Fallback tab label: category used when an FAQ block has no tab label and does not match keyword rules.

FAQ block settings explained

For each FAQ block:

1. Category tab label: optional explicit tab assignment.
2. Question: summary row text.
3. Answer: rich text content shown when expanded.

Important behavior

1. Tabs appear only when Show category tabs is enabled and there is more than one category.
2. If Default tab is blank or invalid, the first available tab is used.
3. If a block has no Category tab label, the theme auto-assigns category by question keywords:
   • Shipping and delivery keywords: ship, delivery, track, assembly, white-glove
   • Returns and warranty keywords: return, damaged, warranty, refund
   • Product details keywords: swatch, trade, designer, material
   • Otherwise it uses Fallback tab label (default: General)
4. On load, the first visible question in the active tab opens automatically.
5. When tabs are off, only the first FAQ item is open by default.
6. Tab keyboard navigation supports Arrow Left/Right, Home, and End.

Common tasks

Add a new FAQ under an existing tab

1. Click Add FAQ.
2. Set Category tab label to the exact tab name you want.
3. Fill question and answer.
4. Save.

Create a new tab category

1. Add or edit one FAQ block.
2. Enter a new Category tab label value.
3. Save and verify a new tab appears.

Force a specific tab to open first

1. Set Default tab to the exact tab text.
2. Save and reload preview.

Show one continuous FAQ list (no tabs)

1. Disable Show category tabs.
2. Save.

Tips

1. Keep category names consistent (avoid near-duplicates like Shipping vs Shipping and delivery).
2. Use short, action-focused questions.
3. Keep answers concise and link to policy pages when needed.
4. Add explicit Category tab label values for predictable grouping.

FAQs

Why did a question appear in the wrong tab?

The block likely has no explicit category label, so keyword auto-assignment placed it.

Why is my default tab not selected on load?

Default tab must match an existing tab label exactly.

Why are tabs not visible?

Either Show category tabs is disabled, or all FAQ items resolve to one category.

Related guides

• Help Center Documentation
• Contact Page Form Documentation
• Theme Documentation
• Contact page

Publish checklist

1. Confirm heading and intro copy.
2. Confirm category labels are consistent.
3. Verify default tab behavior.
4. Test expand/collapse for every FAQ.
5. Validate desktop and mobile behavior.

Need help?

If you still need help, contact support via the Contact page.