Learn · Technical SEO · Beginner

How to check whether a question page suits Q&A markup

Learn to decide whether a page counts as a Q&A page in Google’s terms, check its markup against the rules and test it with Google’s free tools.

Published
Last fact checked
Time
30 minutes to do

What Q&A markup is, and what it is not

Q&A markup is a block of structured data, called QAPage, that tells Google a page is about one question and its answers. It sits in the page’s code and is not visible to visitors.

This guide shows you how to decide whether one of your pages qualifies, how to check the markup against Google’s rules, and how to test it. A page that answers a question is not automatically a Q&A page.

Why Google sets rules for Q&A pages

Google says a page marked up as Q&A is eligible for a rich result, a richer listing in search, and that eligibility is not a guarantee. It also sets content rules: users must be able to submit answers, and it lists an FAQ written by the site itself with no way to add alternative answers as an invalid use. See Google’s Q&A structured data documentation and its general structured data guidelines.

What you need to check a page against Q&A markup

  • The address of one page that answers a question
  • Access to the page’s visible content and, if it has markup, its code
  • A free Google account for the Rich Results Test, and Search Console access to use the URL Inspection tool

Check a question page against Q&A markup, step by step

  1. 1

    Write down what the page is

    Say in one sentence what the page is: a forum thread, a support question, an FAQ, a how-to guide, a blog post. Google’s invalid uses include an FAQ written by the site, a how-to guide, a blog post and an essay. See the content guidelines.

    You will know it worked when You have one sentence naming what the page is.

  2. 2

    Check that visitors can add answers

    Look at the page as a visitor. Google says users must be able to submit answers to the question. If there is no way for anyone else to add a different answer, the page falls outside the documented uses.

    You will know it worked when You can say yes or no: can a second person add an answer to this page?

  3. 3

    Count the questions

    Google says the markup is for pages focused on a single question and its answers, and not for FAQ pages or pages with several questions. Count how many separate questions the page asks.

    You will know it worked when The page has one question, or you have noted that it has more.

  4. 4

    Check the markup matches the page

    If the page already has markup, view its source and find the QAPage block. Compare the question and each answer in it with the text on the page. Google says not to mark up content that is not visible to readers, and the question and answers should be in full.

    You will know it worked when Every question and answer in the markup appears in full on the page.

  5. 5

    Run the Rich Results Test

    Paste the address into Google’s Rich Results Test. It shows whether Google found the markup and any critical errors. A pass does not guarantee the rich result will show.

    You will know it worked when The test reports the markup it found, with no critical errors, or you have a list of errors to fix.

  6. 6

    Check Google can reach the page

    In Search Console, inspect the address with the URL Inspection tool. Google says the page must not be blocked by robots.txt, noindex or a login.

    You will know it worked when The tool reports the page can be crawled and indexed, or shows what blocks it.

  7. 7

    Decide what to do with the markup

    If the page meets the rules, keep the markup. If it does not, remove the markup or use a type that describes the page truthfully. Google says wrong structured data can lead to a manual action, which removes eligibility for the rich result but does not change how the page ranks in web search.

    You will know it worked when You have a decision for each page: keep, fix or remove.

Common mistakes with Q&A markup

  • Adding Q&A markup because the heading is a question. Google’s test is whether users can submit answers.
  • Marking up several questions on one page. Google says QAPage is for a single question.
  • Marking up text that is not on the page, such as an answer that is hidden.
  • Treating a passing Rich Results Test as a promise. Google says a rich result is not guaranteed.
  • Publishing generated answers without a person reading them first. Google says to fact-check generated content before publishing.

Terms used when checking Q&A markup

QAPage
A type of structured data for a page focused on one question and its answers.
Accepted answer
An answer your site has marked as a top answer, for example because the asker or a moderator accepted it.
Generative AI content
Text or other content produced by a model that predicts likely words, which can contain inaccuracies.

Sources for Q&A markup rules

Question pages you are unsure about marking up?

Send Dean a few of the pages and say who writes the answers. A reply from Dean is how it starts, not a sales sequence.