How to add FAQs to the pages that need them
Last checked against Splash 1.0.0 / 2026-08-15
Splash carries two separate FAQ sections. An FAQ set is written once and appears on every page type you tick, always at the foot of the page. The FAQ section is added to one template and appears only there, wherever you place it.
Which one you want#
They look identical on the storefront. They differ in where they are edited and where they can appear.
FAQ set
Lives in the Global FAQ section group. Edit it once and it appears on every page type you switch on: all product pages, all collection pages, all articles. It always renders at the very bottom of the page, after every other section in the template and above the footer. You cannot move it up the page. That fixed position is the trade for having one editable copy.
FAQ
A normal section. Add it to one template from Add section and drag it wherever you want in that template. It appears on that template and nowhere else. Use it when one page needs its own questions, or when you need questions on a page type an FAQ set cannot reach.
Both hold a maximum of 20 questions.
Add an FAQ set#
- Open the theme editor. Any template will do, because the group is edited from all of them.
- In the section list, find Global FAQ. The sets that ship with the theme are inside it.
- Click Add section inside that group and choose FAQ set. It arrives with three empty question blocks.
- Open Where this FAQ appears and tick the page types you want.
- Fill in the question blocks.
Add as many sets as you need. A shipping set on collection pages, a warranty set on product pages and a delivery set on one page are three sets, not one set with three targets.
Where a set appears#
Five checkboxes, all off on a new set. A set with nothing ticked appears on no page at all.
| Checkbox | What it covers |
|---|---|
| Home page | The home page only. |
| Product pages | Every product page in the store. |
| Collection pages | Every collection page. |
| Pages | Every page, including pages using a custom page template such as the quote page or the contact page. |
| Blog and article pages | The blog listing and every article inside it. One checkbox covers both. |
Limit There is no checkbox for the cart, search results, the 404 page or the /collections directory. An FAQ set can never appear on any of those. Add the one-off FAQ section to those templates instead.
Limit An FAQ set never appears on the password page or on the gift card page a customer receives. Both render outside the layout that FAQ sets are part of. The password template does accept sections, so a one-off FAQ section can go there. The gift card page a customer receives takes no sections at all.
Narrowing a page type#
Two text fields sit under the checkboxes. Both take handles, separated by commas. Spaces around the commas are fine, and capitals are fine because the theme lowercases what you type. A handle must match in full: part of a handle matches nothing.
Limit to specific pages
Narrows a page type you have already ticked down to the handles you name. It can only ever remove pages. It can never add a page type you have not ticked. Leave it blank to show the set on every page of the types you selected.
Hide on specific pages
Lifts named pages back out of the set. It is applied last and it wins wherever the two fields disagree, so a handle listed here is hidden even if the same handle is in the field above. Use it to keep one odd product out of a set aimed at all of them.
Three rules worth reading before you use either field.
- Neither field has any effect on the home page. The home page has no handle, so there is nothing to match against. If you want an FAQ set on the home page, the Home page checkbox is the whole of the control.
- Articles match on two handles. An article answers to its own handle and to its blog's handle. Entering a blog's handle in either field therefore covers the blog listing and every post inside it, so you do not have to list your articles one by one.
- A handle that matches nothing shows nothing. If you type a handle with a typo, or a handle for a page that has not been created yet, the set appears on no page of that type. There is no warning. That is the first thing to check when a set that looks correctly configured is missing from the storefront.
Examples#
| You want | Set it up as |
|---|---|
| Questions on every product page | Tick Product pages. Leave both handle fields blank. |
| Questions on one product only | Tick Product pages, then put that product's handle in Limit to specific pages. |
| Questions on every product except your gift card | Tick Product pages, then put the gift card's handle in Hide on specific pages. |
| Questions on two collections | Tick Collection pages, then enter both handles in Limit to specific pages, separated by a comma. |
| Questions on one blog and all of its posts | Tick Blog and article pages, then enter the blog's handle in Limit to specific pages. |
| Questions on one page | Tick Pages, then enter that page's handle in Limit to specific pages. |
A page handle is set in Shopify admin under Content, then Pages, then the page, under Search engine listing. Product, collection, blog and article handles are set the same way on their own records.
Writing the questions#
Each question is a block with three settings.
Show this question
On by default. Turn it off to hide a question from the storefront without deleting it. It stays in the editor so you can bring it back.
Question
Plain text. The row a shopper clicks to open the answer. Angle brackets and ampersands are safe to type.
Answer
Rich text, so links, bold and lists work. It opens beneath the question.
A question renders only when all three are true: it is switched on, the question has text, and the answer has text. If any one of those fails, the question is not on the storefront and it is not in the search engine markup either.
When a question looks filled and is not#
The theme judges an answer by its words, not by its markup. An answer that contains only an empty paragraph, an empty list or spaces counts as empty. Clearing the text out of a rich text field usually leaves an empty paragraph behind, so the field can look occupied in the editor while the question is missing from the live page.
The tell is in the theme editor preview. Where a question would render, you see one of these instead:
| What you see in the editor | What it means |
|---|---|
| Add a question and an answer to show this item. | The question text or the answer text is missing. Fill both in. |
| Hidden: followed by the question | The question is complete but Show this question is off. |
| This set is not shown on this page. Choose where it appears in the section settings. | The set is fine, but the page you are previewing is not one it is targeted at. This is not an error. |
None of those three notes reaches a shopper. They exist so a half-finished question is findable rather than invisible.
If no question in a set is complete, the whole block disappears from the storefront, heading and all. It stays visible in the theme editor so you can finish it.
Heading, caption and intro#
Caption
The small all-caps line above the heading, defaulting to Questions. Leaving it blank still draws the ruler tick mark, which opens every heading in the theme. That is deliberate, not a leftover.
Heading
The section heading, defaulting to Frequently asked. Blank removes the heading line and the questions still render.
Intro
A short paragraph under the heading. Blank leaves it out. It is capped at a readable measure, so a long paragraph wraps rather than running the full width of the page.
Give each set a heading that says what it covers. Three sets all headed Frequently asked are hard to tell apart in the editor's section list.
Search engines#
Both FAQ sections carry a Send these questions to search engines checkbox under SEO and structured data, on by default. It writes FAQPage structured data describing exactly the questions that render, so the markup can never claim an answer a visitor cannot read. On an FAQ set, it is written only on the pages the set actually appears on.
Turn it off on all but one FAQ block per page. Two FAQ blocks on one page means two FAQPage objects in the markup, which Google advises against. Two ways it happens without anyone intending it:
- Two FAQ sets both targeted at product pages.
- An FAQ set targeted at Pages, plus a one-off FAQ section added to one of those page templates.
Decide which block is the page's real FAQ, leave that one on, and turn the setting off on the other. Turning it off changes nothing a shopper sees. More on the theme's structured data is on Shipping, returns and search engine details.
Add a one-off FAQ to a single page#
- In the theme editor, use the template dropdown at the top to open the template you want.
- Click Add section and choose FAQ.
- Drag it to where you want it in the section list.
- Fill in the question blocks. They work exactly as the set's blocks do, including the three conditions above and the 20 block limit.
This is the route for the cart, search, 404 and /collections templates, which FAQ sets cannot reach. It is also the right choice when a single page needs its own questions in a specific position on the page rather than at the foot of it.
The three sets that ship with the theme#
Splash installs with three FAQ sets already written. They are demo copy about pools and pool equipment, so rewrite the questions and answers for your own store. Their targeting is a working example of the three common shapes.
| Set heading | Where it is aimed |
|---|---|
| Frequently asked | Home page. Three questions about shipping, sizing help and how a quote request works. |
| Questions about this product | Product pages, with splash-gift-card in Hide on specific pages. Three questions about sizing, warranty and installation. |
| Design and construction, questions | Pages, limited to the handle quote-request. Three questions about what happens after a request is sent. |
Two things to fix on your store#
The quote set has nowhere to appear until you create the page. It is switched on for Pages and limited to the handle quote-request. Until a page with exactly that handle exists on your store, that set appears nowhere and looks as though the FAQ system is broken. Create the page in Shopify admin under Content, then Pages, set its handle to quote-request under Search engine listing, and assign it the quote theme template. Building the form on it is covered in Build the quote request form. If you use a different handle, put your handle in the set's Limit to specific pages field instead.
The product set excludes the demo store's gift card, not yours. The handle splash-gift-card matches nothing on your store, so the pool sizing and warranty questions will appear on your gift card product page. Open the Questions about this product set, and in Hide on specific pages replace splash-gift-card with your own gift card product's handle. If you sell no gift card, clear the field.
Note Rewriting the demo questions is part of the wider first pass over the theme's shipped content. See Replace the demo content for everything else that ships written in.
If an FAQ is not showing#
Work down this list. The first four causes account for nearly all of it.
- No page type is ticked. A new FAQ set arrives with all five checkboxes off.
- A handle in Limit to specific pages matches nothing. Check it against the handle on the record in Shopify admin, character for character.
- The handle is in Hide on specific pages. That field is applied last and wins over everything above it.
- The answer has no words in it. An empty paragraph left behind by the rich text editor counts as empty. The editor preview says so, in place of the question.
- Show this question is off. The editor preview reads Hidden, followed by the question.
- The page type is one no FAQ set can reach: cart, search, 404,
/collections, the password page, or the gift card page a customer receives. - You are looking for it in the middle of the page. An FAQ set is always at the foot, above the footer. Only the one-off FAQ section can be positioned.
Every setting named on this page is defined in the Section and block reference. If a set is still missing after all seven, contact support with the store URL and the heading of the set.
Something wrong here If a step does not match what you see, say so and it gets fixed. Documentation goes stale, which is why the line under the title carries a date.