> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kwebby.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ page

> Questions grouped under categories, with live search, topic chips with counts, links that open an answer, a contact panel and optional FAQ structured data.

![FAQ page on the storefront](https://mintcdn.com/kwebby/QKNMzt7KPy_yk6ai/images/kelvin/faq-page.webp?fit=max\&auto=format\&n=QKNMzt7KPy_yk6ai\&q=85\&s=1a9490a86f651734b350c82721302081)

FAQ page, highlighted with the demo content

## Where to find it

The faq template (page.faq), shown on the demo at /pages/faq. Create a page in **Online Store → Pages**, choose **faq** under **Theme template** and save. In the theme editor choose **Pages**, then **faq**, and select **FAQ**. The home page has its own, simpler [FAQ](https://docs.kwebby.com/kelvin/sections/faq.md) section.

## How it works

* A Category block starts a group, and the Question blocks after it belong to it until the next Category. Questions before the first Category go under Heading for questions without a category.
* Answers open and close in place, and work without JavaScript.
* The search field filters questions and answers as shoppers type: every word must match, accents are ignored, and matching words are highlighted in the questions. An answer that matches only in its text opens so shoppers see why it is listed.
* A count line follows the search, such as 4 answers for refund; when nothing matches, an empty state offers Clear the search and your first contact button.
* Topic chips, one per category with its count, show when there are two or more groups.
* Links can open an answer or a topic: #faq- followed by the question in lower case with hyphens opens that answer, such as /pages/faq#faq-how-does-in-store-pickup-work; ?cat=pickup picks a category and ?q=refund fills in the search.
* The search and the contact panel sit beside the questions on wide screens. Under 1000 px the search moves above the questions and the contact panel below them.
* Add FAQ structured data describes every question and answer to search engines as an FAQPage. It is off on install.

![FAQ page in the theme editor](https://mintcdn.com/kwebby/QKNMzt7KPy_yk6ai/images/kelvin/editor-faq-page.webp?fit=max\&auto=format\&n=QKNMzt7KPy_yk6ai\&q=85\&s=f7d0494e754f44ac8d1d11275ebececb)

In the theme editor: 1 the section in the sidebar · 2 its settings · 3 the section in the preview

## Edit it

* Add a Category block, then the Question blocks for it, and drag them into order.
* Write each Answer with the real numbers: costs, days and windows. Answers can contain links.
* Edit Search label and Search placeholder, or turn off Show search and topics.
* In the contact panel, edit Heading and Text and set First button link (such as /pages/contact); the button shows only with both its label and link.
* Turn on Add FAQ structured data only if no app already adds FAQ data to the page.

## Settings

| Setting | What it does |
| - | - |
| **Color scheme** | Color scheme for this area (edit the schemes in Theme settings → Colors). Default: Scheme 1. |
| **Link id** | Text. Lets a link such as #questions jump to this section. Letters, numbers and hyphens. |

> [!TIP]
>
> Add a Category block, then the Question blocks that belong to it. Questions before the first category go under the heading below.

| Setting | What it does |
| - | - |
| **Heading for questions without a category** | Text. |

**Search**

| Setting | What it does |
| - | - |
| **Show search and topics** | On or off. Default: on. |
| **Search label** | Text. Default: Search the FAQ. |
| **Search placeholder** | Text. Default: Try refund or pickup. |

**Contact panel**

| Setting | What it does |
| - | - |
| **Heading** | Text. Default: Still need help?. |
| **Text** | Formatted text. |
| **First button label** | Text. Default: Contact us. |
| **First button link** | Link: a page, product, collection or web address. |
| **Second button label** | Text. |
| **Second button link** | Link: a page, product, collection or web address. |

**Search engines**

| Setting | What it does |
| - | - |
| **Add FAQ structured data** | On or off. Describes the questions and answers to search engines as an FAQPage. Default: off. |

## Blocks

Add a block with **Add block** under the section in the sidebar; drag blocks to reorder them.

### Category

| Setting | What it does |
| - | - |
| **Heading** | Text. Default: Shipping. |

### Question

| Setting | What it does |
| - | - |
| **Question** | Text. Default: How long does shipping take?. |
| **Answer** | Formatted text. |

> [!NOTE]
>
> On install the six questions are placeholders that tell you what to write, such as Say what shipping costs: replace every answer. The contact panel's Text is placeholder guidance too (Say how shoppers can reach you and how soon you reply).
>
> Changing a question's wording changes its #faq- link, so update links that point to it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.