> For the complete documentation index, see [llms.txt](https://staylime.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://staylime.com/docs/avante-themes/features-and-advanced-setup/category-specific-faqs.md).
# How to display category-specific FAQs on collection & product pages
Learn how to set up category-specific FAQs in Avante using custom templates, Shopify Pages, or dynamic metafields without writing any code.
By default, Shopify applies the same layout and content across all collection or product pages. If you want to display specific FAQs for different product categories (e.g., Sizing FAQs for Shoes vs. Care Instructions for Leather), Avante provides 3 flexible methods without writing any code.
***
### Method 1: Custom Collection Templates (Best for 2–5 Main Categories)
Use this method when you have a small number of core product categories.
{% stepper %}
{% step %}
#### **Create a template in the Theme Editor:**
* Go to **Shopify Admin → Online Store → Themes → Edit theme**.
* In the top page dropdown, select **Collections → Create template**.
* Name your template logically (e.g., `shoes`, `dresses`).
{% endstep %}
{% step %}
#### **Add and customize the FAQ section:**
* Click **Add section → Collapsible tabs**.
* Add **Tab** blocks and enter the unique questions and answers for this category.
{% endstep %}
{% step %}
#### **Assign the template to a Collection:**
* Go to **Shopify Admin → Products → Collections** and open your category page.
* On the right sidebar, under **Theme template**, select your new template (e.g., `dresses`) and click **Save**.
{% endstep %}
{% endstepper %}
***
### Method 2: Connecting Shopify Pages to Collapsible Tabs (Best for Shared Category Guides)
Use this method if multiple products or collections share the exact same care guide or category FAQ, and you want to manage content from one central place.
{% stepper %}
{% step %}
#### **Create a Page for each Category FAQ:**
* Go to **Shopify Admin → Online Store → Pages → Add page**.
* Title it (e.g., *"Packaging & FAQ"*) and enter your questions and answers in the content editor.
{% endstep %}
{% step %}
#### **Link the Page in Theme Editor:**
* Open **Theme Editor** and select your collection or product template.
* In the **Collapsible tabs** section, select a **Tab** block.
* In the **Page** setting, pick the page you just created.
{% endstep %}
{% endstepper %}
***
### Method 3: Dynamic Metafields (Best for Large Catalogs)
Use this method if you have dozens of categories or want a fully scalable setup that dynamically hides empty FAQ tabs.
{% stepper %}
{% step %}
#### **Create a Metafield definition:**
* Go to **Shopify Admin → Settings → Metafields and metaobjects → Collections** *(or Products)*.
* Click **Add definition**.
* Set **Name** to `Category FAQ` (Key: `custom.category_faq`).
* Select **Type**: **Page reference** *(or Multi-line text)* and save.
{% endstep %}
{% step %}
#### **Assign the FAQ Page to each Collection:**
* Go to **Shopify Admin → Products → Collections** and select a collection.
* Scroll down to **Metafields** and select the corresponding FAQ Page.
{% endstep %}
{% step %}
#### **Connect the Dynamic Source in Theme Editor:**
* Open **Theme Editor → Default collection template**.
* In **Collapsible tabs**, select a **Tab** block.
* Next to the **Page** setting, click the **Connect dynamic source icon (`<>`)**.
* Select your `Category FAQ` metafield.
{% endstep %}
{% endstepper %}
{% hint style="success" icon="lightbulb-on" %}
**Pro Tip:** If a collection leaves the `Category FAQ` metafield blank, the FAQ tab will automatically hide on the storefront for that category without leaving empty spaces!
{% endhint %}
{% hint style="warning" %}
**Note on Page Content:** When connecting a Shopify Page to a single **Tab** block, the entire page content (all questions & answers) will render inside that one expandable tab (e.g., *"Dresses FAQ"*). If you prefer each question to have its own separate expandable accordion row, use **Method 1 (Custom Templates)** to add individual Tab blocks for each question.
{% endhint %}
***
### Related
* [How do I show different content per product?](/docs/avante-themes/faq/products-and-variants/how-do-i-show-different-content-per-product.md) — guide on using dynamic sources for product-level content
* [Default collection template](/docs/avante-themes/templates/default-collection.md) — how to create and assign collection templates in Avante
* [Shopify: Displaying metafields on your online store](https://help.shopify.com/en/manual/custom-data/metafields/displaying-metafields-on-your-online-store) — Shopify's official guide on dynamic sources
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://staylime.com/docs/avante-themes/features-and-advanced-setup/category-specific-faqs.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
.png?alt=media&token=0403129d-e916-4baa-ba39-325a10a0188c)
.png?alt=media&token=02216c3b-64b1-4283-a7f9-2613355e7351)
.png?alt=media&token=21563336-bedf-4efc-9fe6-35b36ea3fd45)
.png?alt=media&token=e31316e2-1afc-4b12-ba2f-07cf2239661b)
.png?alt=media&token=f2dff9df-35dc-4bcc-abf3-2c39bdc8747c)
.png?alt=media&token=7a31bf7f-4658-4425-b80d-7679369ff4cf)
.png?alt=media&token=2ef3097e-c204-4690-b511-5b3c9c769604)
.png?alt=media&token=0af5d8c3-b2f2-4874-be2f-59bee40a57d3)