Index of every page on this site: llms.txt
Unhead
Vue
Recipes
On this page

Use defineQuestion() with defineWebPage({ '@type': 'FAQPage' }) to mark up FAQ content and connect each Question to the page's mainEntity property.

Google stopped showing FAQ rich results on May 7, 2026. FAQPage markup remains valid Schema.org structured data, but it no longer creates a Google Search rich result.

Useful Links

How do I mark up FAQs?

defineQuestion creates a Question node and resolves a string answer to an Answer object.

When the configured page path ends in /faq, defineWebPage() infers the FAQPage subtype.

Tips:

  • The answer may contain HTML content such as links and lists.
import { defineQuestion, defineWebPage, useSchemaOrg } from '@unhead/schema-org/vue'

useSchemaOrg([
  defineWebPage({
    '@type': 'FAQPage',
  }),
  defineQuestion({
    name: 'How long does delivery take?',
    acceptedAnswer: 'Most orders arrive within three to five business days.',
  }),
  defineQuestion({
    name: 'Can I return an item?',
    acceptedAnswer: 'You can return an unused item within 30 days of delivery.',
  }),
])

How should I structure FAQ content in HTML?

Keep the visible questions and answers consistent with the schema markup:

<div>
  <h1>Frequently Asked Questions</h1>

  <div>
    <h2>How long does delivery take?</h2>
    <div>Most orders arrive within three to five business days.</div>
  </div>

  <div>
    <h2>Can I return an item?</h2>
    <div>You can return an unused item within 30 days of delivery.</div>
  </div>
</div>

Can I use HTML in FAQ answers?

Answer strings may contain HTML, including paragraphs, links, and lists:

import { defineQuestion, defineWebPage, useSchemaOrg } from '@unhead/schema-org/vue'

useSchemaOrg([
  defineWebPage({
    '@type': 'FAQPage',
  }),
  defineQuestion({
    name: 'How do I start a return?',
    acceptedAnswer: `
      <p>Open the order in your account and select “Start a return.”</p>
      <p><a href="/returns">Read the return policy</a> before sending the item.</p>
    `,
  }),
])

Abridged JSON-LD Output

With a host of https://example.com, a path of /faq, and a page title of FAQ, the output for the first question looks like this:

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": ["WebPage", "FAQPage"],
      "@id": "https://example.com/faq#webpage",
      "name": "FAQ",
      "url": "https://example.com/faq",
      "mainEntity": [
        { "@id": "https://example.com/faq#/schema/question/1" }
      ]
    },
    {
      "@id": "https://example.com/faq#/schema/question/1",
      "@type": "Question",
      "name": "How long does delivery take?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Most orders arrive within three to five business days."
      }
    }
  ]
}

Common Issues

FAQ not showing as a rich result

Google no longer shows FAQ rich results. This is expected even when the markup is valid.

Questions not appearing

Include both defineWebPage({ '@type': 'FAQPage' }) and defineQuestion() to have Unhead add Question references to the page's mainEntity property.

Is HTML in answers stripped?

Unhead preserves the answer string and escapes it safely inside the JSON-LD script. It does not sanitize HTML supplied in the answer.

Related Recipes

Edit this page
Markdown For LLMs
Did this page help you?

Schema.org for E-commerce Sites

Add Product structured data with defineProduct() so product pages can become eligible for search features showing prices, ratings, availability, and reviews.

Schema.org for How-To Content

Add HowTo structured data with defineHowTo(), including steps, images, supplies, tools, and time estimates.