S SCHEMA.BIZ
Content Extends: WebPage

QAPage Schema

QAPage schema marks up a page where one question is asked and users answer it: a thread on a Q&A forum, a community support page, a question on an expert community. The page is a QAPage whose mainEntity is the Question, with its short form in name, the number of answers, and each Answer's text, votes, author and link. It isn't for FAQ pages the site writes itself.

Last updated:

Does Google show QAPage schema?

Yes Google reads QAPage markup for this feature: Q&A.

  • Q&A Active

    A question and its answers from a page where users answer questions.

    Last change in Google's documentation: March 24, 2026. Google documented more supported properties for questions and answers.

Last checked against Google's documentation: .

When to Use QAPage

Q&A community question pages Community support questions with user answers Forum boards for questions and answers Expert communities where answers can be accepted

What Google requires

schema.org defines 139 properties a QAPage can use, counting the ones it inherits. Google reads only a few of them for each feature; the rest are valid schema.org that Google doesn't require.

Q&A: 1 required, 0 recommended Google's documentation

Property Google schema.org expects
mainEntity required Thing

QAPage properties

The properties that matter most in practice, of the 139 schema.org defines for QAPage. Status is our advice for a complete description; Google's own requirements are in the table above.

Property Type Status Description
mainEntity Question required The one question the page is about, with its answers. One QAPage per page.
url URL optional The question page's canonical address.
name Text optional The page title. Google reads the question itself from mainEntity.name.
description Text optional A summary of the page, if you have one. The question's full text goes in mainEntity.text.
inLanguage Text optional The language of the question and answers, as a BCP 47 code.
isPartOf WebSite or CollectionPage optional The site, or the category or tag the question is filed under.
breadcrumb BreadcrumbList optional The trail to the question, such as Questions > Baking > Sourdough.
dateCreated DateTime optional When the page was created. Google reads the question's own datePublished instead.
dateModified DateTime optional When the page last changed, such as when an answer was added.

Note: On the Question, Google requires name (the short form of the question), answerCount, and acceptedAnswer or suggestedAnswer. It recommends text (the full question), author with a url, datePublished, dateModified, upvoteCount, comment, commentCount, image, video and digitalSourceType.

Note: On each Answer, Google requires text, the full answer. It strongly recommends url, a link to the answer itself, and recommends upvoteCount, author, datePublished, dateModified, comment, commentCount, image, video and digitalSourceType. A Comment under a question or answer needs text.

JSON-LD Examples

Once you've adapted an example, check your schema markup for errors and Google rich result eligibility.

Minimal:A question with one accepted answer

What Google requires: a QAPage whose mainEntity is a Question with its name and answerCount, and an Answer with its text.

{
  "@context": "https://schema.org",
  "@type": "QAPage",
  "mainEntity": {
    "@type": "Question",
    "name": "Why does my sourdough starter smell like nail polish remover?",
    "answerCount": 1,
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "That acetone smell means the starter is hungry: the yeast has run out of food and is producing ethyl acetate. Feed it more often, or at a higher ratio such as 1:5:5, and the smell goes within a day or two."
    }
  }
}

Complete:A question with accepted and suggested answers, votes and authors

Everything Google's Q&A documentation lists that a typical community page has: the full question text, its author and dates, the vote total, and for each answer its text, a url with a fragment that points at it, votes, author and date.

{
  "@context": "https://schema.org",
  "@type": "QAPage",
  "mainEntity": {
    "@type": "Question",
    "name": "Why does my sourdough starter smell like nail polish remover?",
    "text": "My two-week-old rye starter rises well but smells strongly of acetone about eight hours after feeding. I feed it 1:1:1 once a day and keep it at about 75°F. Is it spoiled?",
    "answerCount": 2,
    "upvoteCount": 41,
    "datePublished": "2026-05-11T07:52:00-04:00",
    "dateModified": "2026-05-11T08:10:00-04:00",
    "author": {
      "@type": "Person",
      "name": "Elena Marsh",
      "url": "https://bakers.example.com/users/elena-marsh/"
    },
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "That acetone smell means the starter is hungry: the yeast has run out of food and is producing ethyl acetate. Feed it more often, or at a higher ratio such as 1:5:5, and the smell goes within a day or two.",
      "url": "https://bakers.example.com/questions/8841/sourdough-starter-acetone-smell#answer-21907",
      "upvoteCount": 57,
      "datePublished": "2026-05-11T09:30:00-04:00",
      "author": {
        "@type": "Person",
        "name": "Hiroshi Tanaka",
        "url": "https://bakers.example.com/users/hiroshi-tanaka/"
      }
    },
    "suggestedAnswer": {
      "@type": "Answer",
      "text": "Try moving it somewhere cooler, around 68°F. At 75°F a 1:1:1 starter peaks fast and then starves for the rest of the day.",
      "url": "https://bakers.example.com/questions/8841/sourdough-starter-acetone-smell#answer-21915",
      "upvoteCount": 12,
      "datePublished": "2026-05-11T11:04:00-04:00",
      "author": {
        "@type": "Person",
        "name": "Grace Mbeki",
        "url": "https://bakers.example.com/users/grace-mbeki/"
      }
    }
  }
}

Real-world, nested:A community Q&A page with comments and a machine-written answer

The page in an @graph with its site and breadcrumb. The question has a clarifying Comment, the accepted answer has a reply in comment, and an answer drafted by the site's assistant is marked with digitalSourceType. The authors are linked to their profile pages.

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "QAPage",
      "@id": "https://bakers.example.com/questions/8841/sourdough-starter-acetone-smell",
      "url": "https://bakers.example.com/questions/8841/sourdough-starter-acetone-smell",
      "inLanguage": "en",
      "isPartOf": {
        "@id": "https://bakers.example.com/#website"
      },
      "breadcrumb": {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Questions",
            "item": "https://bakers.example.com/questions/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Sourdough",
            "item": "https://bakers.example.com/questions/tagged/sourdough/"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Starter smells like acetone"
          }
        ]
      },
      "mainEntity": {
        "@type": "Question",
        "name": "Why does my sourdough starter smell like nail polish remover?",
        "text": "My two-week-old rye starter rises well but smells strongly of acetone about eight hours after feeding. I feed it 1:1:1 once a day. Is it spoiled?",
        "answerCount": 3,
        "upvoteCount": 41,
        "datePublished": "2026-05-11T07:52:00-04:00",
        "author": {
          "@type": "Person",
          "name": "Elena Marsh",
          "url": "https://bakers.example.com/users/elena-marsh/"
        },
        "commentCount": 1,
        "comment": {
          "@type": "Comment",
          "text": "What flour are you feeding it, rye or white?",
          "datePublished": "2026-05-11T08:01:00-04:00",
          "author": {
            "@type": "Person",
            "name": "Grace Mbeki",
            "url": "https://bakers.example.com/users/grace-mbeki/"
          }
        },
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "That acetone smell means the starter is hungry: the yeast has run out of food and is producing ethyl acetate. Feed it more often, or at a higher ratio such as 1:5:5, and the smell goes within a day or two.",
          "url": "https://bakers.example.com/questions/8841/sourdough-starter-acetone-smell#answer-21907",
          "upvoteCount": 57,
          "datePublished": "2026-05-11T09:30:00-04:00",
          "author": {
            "@type": "Person",
            "name": "Hiroshi Tanaka",
            "url": "https://bakers.example.com/users/hiroshi-tanaka/"
          },
          "comment": {
            "@type": "Comment",
            "text": "Switched to 1:5:5 twice a day and the smell was gone by the next morning. Thanks!",
            "datePublished": "2026-05-12T19:15:00-04:00",
            "author": {
              "@type": "Person",
              "name": "Elena Marsh",
              "url": "https://bakers.example.com/users/elena-marsh/"
            }
          }
        },
        "suggestedAnswer": [
          {
            "@type": "Answer",
            "text": "Try moving it somewhere cooler, around 68°F. At 75°F a 1:1:1 starter peaks fast and then starves for the rest of the day.",
            "url": "https://bakers.example.com/questions/8841/sourdough-starter-acetone-smell#answer-21915",
            "upvoteCount": 12,
            "datePublished": "2026-05-11T11:04:00-04:00",
            "author": {
              "@type": "Person",
              "name": "Grace Mbeki",
              "url": "https://bakers.example.com/users/grace-mbeki/"
            }
          },
          {
            "@type": "Answer",
            "text": "An acetone smell in a young starter usually means it needs feeding more often. Members in similar threads fixed it by feeding twice a day.",
            "url": "https://bakers.example.com/questions/8841/sourdough-starter-acetone-smell#answer-21920",
            "upvoteCount": 2,
            "datePublished": "2026-05-11T07:53:00-04:00",
            "author": {
              "@type": "Organization",
              "name": "Bakers Exchange Assistant",
              "url": "https://bakers.example.com/assistant/"
            },
            "digitalSourceType": "https://schema.org/TrainedAlgorithmicMediaDigitalSource"
          }
        ]
      }
    },
    {
      "@type": "WebSite",
      "@id": "https://bakers.example.com/#website",
      "name": "Bakers Exchange",
      "url": "https://bakers.example.com/"
    }
  ]
}

Common QAPage schema mistakes

Leaving out answerCount

REQ_MISSING: Google requires this property for the search feature. Without it the page isn't eligible for that rich result, although the markup is still valid schema.org.

answerCount is the total number of answers to the question, not just those marked up.

Wrong

{
  "@context": "https://schema.org",
  "@type": "QAPage",
  "mainEntity": {
    "@type": "Question",
    "name": "Why does my sourdough starter smell like nail polish remover?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "That acetone smell means the starter is hungry: the yeast has run out of food and is producing ethyl acetate. Feed it more often, or at a higher ratio such as 1:5:5, and the smell goes within a day or two."
    }
  }
}

Right

{
  "@context": "https://schema.org",
  "@type": "QAPage",
  "mainEntity": {
    "@type": "Question",
    "name": "Why does my sourdough starter smell like nail polish remover?",
    "answerCount": 1,
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "That acetone smell means the starter is hungry: the yeast has run out of food and is producing ethyl acetate. Feed it more often, or at a higher ratio such as 1:5:5, and the smell goes within a day or two."
    }
  }
}

Putting the answer on the QAPage instead of the Question

PROP_NOT_ON_TYPE: This schema.org property isn't defined for the object's type, so search engines may ignore it.

acceptedAnswer and suggestedAnswer are Question properties. On the page, Google sees a question with no answers.

Wrong

{
  "@context": "https://schema.org",
  "@type": "QAPage",
  "acceptedAnswer": {
    "@type": "Answer",
    "text": "That acetone smell means the starter is hungry: the yeast has run out of food and is producing ethyl acetate. Feed it more often, or at a higher ratio such as 1:5:5, and the smell goes within a day or two."
  },
  "mainEntity": {
    "@type": "Question",
    "name": "Why does my sourdough starter smell like nail polish remover?",
    "answerCount": 1
  }
}

Right

{
  "@context": "https://schema.org",
  "@type": "QAPage",
  "mainEntity": {
    "@type": "Question",
    "name": "Why does my sourdough starter smell like nail polish remover?",
    "answerCount": 1,
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "That acetone smell means the starter is hungry: the yeast has run out of food and is producing ethyl acetate. Feed it more often, or at a higher ratio such as 1:5:5, and the smell goes within a day or two."
    }
  }
}

Writing the vote count as the page displays it

VALUE_TYPE: The value isn't one of the kinds schema.org expects for this property.

upvoteCount is an integer. Google asks for one aggregate number: upvotes minus downvotes on sites that have both.

Wrong

{
  "@context": "https://schema.org",
  "@type": "QAPage",
  "mainEntity": {
    "@type": "Question",
    "name": "Why does my sourdough starter smell like nail polish remover?",
    "answerCount": 1,
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "That acetone smell means the starter is hungry: the yeast has run out of food and is producing ethyl acetate. Feed it more often, or at a higher ratio such as 1:5:5, and the smell goes within a day or two.",
      "upvoteCount": "57 votes"
    }
  }
}

Right

{
  "@context": "https://schema.org",
  "@type": "QAPage",
  "mainEntity": {
    "@type": "Question",
    "name": "Why does my sourdough starter smell like nail polish remover?",
    "answerCount": 1,
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "That acetone smell means the starter is hungry: the yeast has run out of food and is producing ethyl acetate. Feed it more often, or at a higher ratio such as 1:5:5, and the smell goes within a day or two.",
      "upvoteCount": 57
    }
  }
}

Suggested answers without @type Answer

TYPE_MISSING_NESTED: Nested objects should say what they are too. Without an @type, search engines have to guess, and Google's features may not recognise the object.

Wrong

{
  "@context": "https://schema.org",
  "@type": "QAPage",
  "mainEntity": {
    "@type": "Question",
    "name": "Why does my sourdough starter smell like nail polish remover?",
    "answerCount": 1,
    "suggestedAnswer": {
      "text": "That acetone smell means the starter is hungry: the yeast has run out of food and is producing ethyl acetate. Feed it more often, or at a higher ratio such as 1:5:5, and the smell goes within a day or two."
    }
  }
}

Right

{
  "@context": "https://schema.org",
  "@type": "QAPage",
  "mainEntity": {
    "@type": "Question",
    "name": "Why does my sourdough starter smell like nail polish remover?",
    "answerCount": 1,
    "suggestedAnswer": {
      "@type": "Answer",
      "text": "That acetone smell means the starter is hungry: the yeast has run out of food and is producing ethyl acetate. Feed it more often, or at a higher ratio such as 1:5:5, and the smell goes within a day or two."
    }
  }
}

Giving each answer's url as a bare fragment

VALUE_URL: This property expects an absolute URL, including https://. Relative paths can't be resolved reliably.

Google wants the page URL plus a fragment that lands on the answer, so the anchor must exist in the HTML too.

Wrong

{
  "@context": "https://schema.org",
  "@type": "QAPage",
  "mainEntity": {
    "@type": "Question",
    "name": "Why does my sourdough starter smell like nail polish remover?",
    "answerCount": 1,
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "That acetone smell means the starter is hungry: the yeast has run out of food and is producing ethyl acetate. Feed it more often, or at a higher ratio such as 1:5:5, and the smell goes within a day or two.",
      "url": "#answer-21907"
    }
  }
}

Right

{
  "@context": "https://schema.org",
  "@type": "QAPage",
  "mainEntity": {
    "@type": "Question",
    "name": "Why does my sourdough starter smell like nail polish remover?",
    "answerCount": 1,
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "That acetone smell means the starter is hungry: the yeast has run out of food and is producing ethyl acetate. Feed it more often, or at a higher ratio such as 1:5:5, and the smell goes within a day or two.",
      "url": "https://bakers.example.com/questions/8841/sourdough-starter-acetone-smell#answer-21907"
    }
  }
}

Also watch for

  • Using QAPage on an FAQ page the site wrote itself, with several questions and no way for users to answer. Google lists that as invalid; those pages were FAQPage material, and Google retired FAQ rich results in 2026.

  • Putting several questions on one QAPage, such as a product page where shoppers ask and answer many questions. Google's Q&A markup is for a page about one question.

  • Marking an answer as acceptedAnswer because it is the newest or the most upvoted. Use acceptedAnswer for an answer accepted on the site, by the asker or a moderator, and suggestedAnswer for the rest.

  • Marking up clarifying remarks as answers. Google asks for those to be Comment objects in the question's or answer's comment property.

One question, answered by users

Google's Q&A markup has a narrow target: a page focused on a single question, where users can submit answers. Its own valid examples are a forum page where users answer one question and a product support page where users answer one question. Its invalid examples are an FAQ page written by the site with no way to submit other answers, a product page with many questions and answers, and how-to guides, blog posts or essays that answer a question.

Two tests settle most cases. First, is there one question that the page is about? A thread that wanders into several topics is still about its opening question; a page listing twenty questions isn't. Second, can users answer it? If only staff write the answers, it isn't a community Q&A page, whatever the layout looks like.

Apply the markup per page, not site-wide. Google says not to add it to every page of a site or forum when some pages aren't eligible questions: category pages, tag lists, user profiles and announcements stay out. In the template, output QAPage only on question pages, and only once per page; Google says there must be one QAPage type definition per page.

Accepted, suggested and counted answers

The Question carries the answers in two properties. acceptedAnswer is an answer the site has accepted as the top answer, usually chosen by the person who asked or by a moderator. suggestedAnswer holds every other answer. Google requires at least one of the two, and each Answer needs its full text; a teaser that cuts off after a sentence may not be shown.

answerCount is the total number of answers, including any you don't mark up because they're on a later page or hidden behind "Show more". A question with no answers yet gets answerCount 0, but it isn't eligible for the rich result until an answer exists, so there's no need to output empty answer arrays.

upvoteCount appears on the Question and on each Answer. Google asks for a single number: on sites with up and down votes, give the net score the page shows. If the page doesn't show votes, leave the property out rather than sending 0.

When answers change state, update the markup from the same data that drives the page. An accepted answer that loses its accepted mark moves to suggestedAnswer; a deleted answer leaves the markup and lowers answerCount.

Answer URLs, comments and machine-written answers

Google strongly recommends a url on each Answer: the question page's address plus a fragment that lands on that answer, such as #answer-21907. Use the same fragment as the element's id in the HTML, so following the link scrolls to the answer. The fragment should be stable, built from the answer's database ID, not from its position on the page, which changes as votes reorder answers.

Remarks that ask for clarification or thank someone aren't answers. Mark them up as Comment objects in the comment property of the question or answer they're attached to, with commentCount when not all of them are shown. Comments can nest, the same way as on a discussion forum.

Authors should be Person or Organization objects with a name and a url to their profile page, where ProfilePage markup can describe them with their handle and reputation counts. If the site posts answers generated by a trained model, add digitalSourceType with https://schema.org/TrainedAlgorithmicMediaDigitalSource; for simpler automated answers use https://schema.org/AlgorithmicMediaDigitalSource. Without it Google assumes a person wrote the content.

Q&A, forum or FAQ: choosing per page, and testing

Three types compete for question-shaped pages. QAPage fits one question that users answer. DiscussionForumPosting fits a forum thread that's a conversation rather than a question with answers; Google's forum documentation sends question-and-answer threads to QAPage. FAQPage described a site's own list of questions and answers; Google stopped showing FAQ rich results in 2026, and putting a site-written FAQ in QAPage markup doesn't make it eligible for Q&A results.

On a community that has both discussion and Q&A sections, choose the type in the thread template from the board's setting, not from whether a title ends in a question mark.

To test, paste a question page's markup into the Validator at /markup/validator/. It checks that the Question has a name and answerCount, that there is an accepted or suggested answer, and that every answer has text. Test an unanswered question, a question with an accepted answer and one with only suggested answers, since templates often break in one of the three. Google's Rich Results Test then shows whether Google reads the Q&A markup on the live page.

Complete Guide to QAPage Schema

Google's Q&A rich result shows a question from a community page together with a preview of its answers. Google reads the markup from a QAPage whose mainEntity is a Question; the question's name is the short form people see, its answerCount says how many answers exist, and each Answer's text and url provide the answer and a link straight to it.

In March 2026 Google documented more supported properties for Q&A markup, alongside the same update to its forum documentation. The Q&A documentation now lists comments and comment counts on questions and answers, digitalSourceType for machine-generated content, and image and video on questions and answers. Questions and answers can carry their own dateModified as well as datePublished.

The content rules matter as much as the properties. Google says not to use Q&A markup for advertising, and content that's obscene, sexually explicit, violent or hateful may not be shown as a rich result. The question and every answer must include their entire text, and the markup must match what visitors see on the page.

QAPage is a WebPage subtype, so the page object can also carry breadcrumb, isPartOf and inLanguage, which describe the page rather than the question. Keep those on the QAPage and everything about the question and answers on the Question and its Answer objects.

Where QAPage sits in schema.org

"A QAPage is a WebPage focussed on a specific Question and its Answer(s), e.g. in a question answering site or documenting Frequently Asked Questions (FAQs)."

schema.org's definition of QAPage

Path from Thing: Thing CreativeWork WebPage QAPage

Parent type
WebPage
More specific types
None: QAPage has no subtypes in schema.org.

Related Types

Ready to Create QAPage Markup?

Use our free generator to create valid QAPage JSON-LD markup with a visual form. No coding required.

Open Generator