How to Add FAQ Schema to Your Shopify Store (Without Breaking Your Theme)

Creating the FAQ Section (This Is Where the Magic Happens)

Now you've got a library of FAQs sitting in your Shopify admin. Next step: create a section that actually displays them on your store and generates the FAQ schema automatically.

Step 4: Create the Section File

Go to Online Store → Themes → Actions → Edit code.

In the left sidebar, under Sections, click Add a new section.

Name it: faq-schema (no spaces, lowercase).

Shopify creates the file faq-schema.liquid. Delete any boilerplate code Shopify put in there.

Paste this code:

<div class="faq-section">
  {% if section.settings.heading != blank %}
    <h2>{{ section.settings.heading }}</h2>
  {% endif %}

  {% assign faq_list = section.settings.faq_list %}

  {% if faq_list and faq_list.size > 0 %}
    <div class="faq-items">
      {% for faq in faq_list %}
        <div class="faq-item">
          <h3>{{ faq.question.value }}</h3>
          <div>{{ faq.answer.value | newline_to_br }}</div>

          {% if faq.link.value != blank %}
            <p>
              <a href="{{ faq.link.value }}">Learn more</a>
            </p>
          {% endif %}
        </div>
      {% endfor %}
    </div>

    {%- comment -%}
      FAQPage JSON-LD schema - this is what Google and ChatGPT read
    {%- endcomment -%}
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "FAQPage",
      "mainEntity": [
        {% for faq in faq_list %}
        {
          "@type": "Question",
          "name": {{ faq.question.value | strip_html | strip | json }},
          "acceptedAnswer": {
            "@type": "Answer",
            "text": {{ faq.answer.value | strip_html | strip | json }}
          }
        }{% unless forloop.last %},{% endunless %}
        {% endfor %}
      ]
    }
    </script>
  {% endif %}
</div>

{% schema %}
{
  "name": "FAQ with Schema",
  "settings": [
    {
      "type": "text",
      "id": "heading",
      "label": "Section Heading",
      "default": "Frequently Asked Questions"
    },
    {
      "type": "list.metaobject",
      "id": "faq_list",
      "label": "Select FAQ Items",
      "accept": ["faq"]
    }
  ],
  "presets": [
    {
      "name": "FAQ with Schema"
    }
  ]
}
{% endschema %}

Click Save.

What This Code Actually Does

Let me break down the strategic pieces so you understand what's happening:

The visible FAQ display: The top section renders your questions and answers on the page. Customers can read them, click optional "Learn more" links, and get their answers.

The JSON-LD schema block: This is the invisible code that Google, ChatGPT Shopping, and other AI agents read. It tells them "this is a FAQ page, here are the questions and answers in a format I understand." This is what gets you rich snippets in search results and makes your content discoverable by AI.

The schema settings: The "accept": ["faq"] line connects this section to your FAQ metaobject. The section knows to look for entries from your FAQ library. If you named your metaobject type something different (like faqs or faq_item), update this line to match.

This approach means you're not just dumping FAQs on a page—you're making them machine-readable, which is the entire point in 2025.