Skip to main content

FAQ page

Merchant Developer

The FAQ page template (page.faq) that answers common questions using a page header, an accordion, and a closing call to action.

The FAQ page is a ready-made support layout built from three stacked sections: a page header, a collapsible accordion of questions and answers, and a closing call to action that points shoppers to your contact page. Like the About page, it reuses existing theme sections, so each part is edited independently in the theme editor.

storefront previewResult
FAQ page
FAQ page
storefront previewSettings
FAQ page template in the theme editor - page header, accordion and call to action
FAQ page template in the theme editor - page header, accordion and call to action

Sections on this template​

In order:

#Section on the pageSection typeDocumented under
1Page headerpage-mainPage (Main Content)
2FAQproduct-accordionAccordion
3Call to actionabout-ctaAbout - Call to Action

How to use it​

For merchants

In the Shopify theme editor:

  1. In Shopify admin go to Online Store → Themes → Customize.
  2. In the top template picker choose Pages → FAQ (the page using the page.faq template).
  3. Open the FAQ section and edit each Accordion item block - set the Item title (the question) and Item content (the answer).
  4. Click Add block → Accordion item to add more questions, and drag to reorder them.
  5. Edit the Page header heading and the closing Call to action heading, button label, and link as needed.
  6. Click Save to publish your changes.
tip

Each section has its own full documentation - open the linked page in the table above for every setting. This page only covers how the template is assembled.

tip

The FAQ list is the standard Accordion section, so answers are rich text - you can add links and formatting (for example a link to Order history or your returns policy).

tip

To create the page itself, add a page in Online Store → Pages and set its Theme template to page.faq.

Developer notes​

Developer note

The page is defined by templates/page.faq.json, which sets order and seeds each section's settings and blocks. There is no dedicated faq section - the accordion is the shared product-accordion section.

  • Default order: faq_header (page-main) → faq (product-accordion, with accordion_item blocks) → faq_cta (about-cta).
  • The seeded about-cta points its button at /pages/contact with a Still have questions? heading and Contact us label.
  • Every block is a normal section, so each is editable, hideable, and reorderable in the editor independently; merchants can swap in other sections too.
"order": [
  "faq_header",
  "faq",
  "faq_cta"
]