S SCHEMA.BIZ

Last updated:

QAPage Schema Generator

This QAPage schema generator turns a question thread into QAPage JSON-LD as you type. Fill in the question one of your users asked, the accepted answer if there is one and the other answers, with their authors, votes and links, then paste the script tag into that question's own page.

Reference: QAPage schema

Q&A Page: Use on a page with a single question that your users answer, as on a forum or support community. Not for an FAQ your site writes itself, or for a page with several questions.

Question
Accepted Answer
Other Answers

What Google shows for QAPage markup

  • Q&A: shown in Google Search; Google's last documented change was on March 24, 2026.

Google reads QAPage markup on one kind of page: a single question followed by its answers, on a site where users can post answers, such as a support community or a forum. Valid markup makes the page eligible for the Q&A result; Google decides whether it appears.

Google rules out an FAQ your site wrote itself, a product page with several questions and answers, how-to guides and blog posts, and a page with one answer and no way for visitors to add another. If the page has more than one question, or only your staff can answer, leave QAPage out.

How to fill in each field

The question

Question is the short form, the title the thread shows; Google requires it. Question Details is the full question as the asker wrote it. Asked By and Asker's Profile URL become the question's author, a Person linked to their profile on your site.

Dates, votes and the answer count

Put your UTC offset in Time Zone, such as -07:00 or Z; the form adds it to every date that has a time. Question Votes is one number: on a site with down votes, give up votes minus down votes.

Number of Answers is the question's total, counting answers you don't mark up, such as those on a second page. Left empty, the form counts the answers you entered, or writes 0 when there are none.

Accepted Answer

Fill in this group only when the asker or a moderator accepted an answer; left empty, it writes no acceptedAnswer. Google requires the answer's full text, so don't enter a name or votes without it. Answer URL links straight to the answer, such as the thread's address plus #answer-5310; Google strongly recommends it.

Other Answers

Press + Add Other Answer for each answer that wasn't accepted, in the order the page lists them. Each row becomes a suggestedAnswer. Its Answered On is a date and time picker, and the form adds the time zone, as it does for the question's dates.

The form marks 1 field as required and 7 as recommended:

  • Question (required): The question in short form, as its title reads.
  • Question Details (recommended): The full question, as the person asked it.
  • Asked By (recommended): The name of the person who asked, as the page shows it.
  • Asker's Profile URL (recommended): Their profile page on your site.
  • Asked On (recommended): When the question was posted.
  • Time Zone (UTC offset) (recommended): Added to every date in this form: an offset such as -05:00, or Z for UTC.
  • Question Votes (recommended): The question's vote total. If your site has down votes too, give up votes minus down votes.
  • Other Answers (recommended): Answers that aren't accepted, in the order the page shows them. Google needs at least one answer, accepted or not.

Example: A cycling forum question with an accepted answer

The asker's question, the answer they accepted and one other answer, each with a direct link. Number of Answers is 3 because the thread has a third answer the example leaves out.

{
  "@context": "https://schema.org",
  "@type": "QAPage",
  "mainEntity": {
    "@type": "Question",
    "name": "Why does my chain skip in the smallest rear cog?",
    "text": "Since I fitted a new cassette, the chain jumps every few pedal strokes in the highest gear, mostly when I stand to climb. The other gears shift fine. What should I check first?",
    "answerCount": 3,
    "upvoteCount": 9,
    "datePublished": "2026-08-02T18:20-07:00",
    "author": {
      "@type": "Person",
      "name": "Priya Desai",
      "url": "https://spokesforum.example/users/priya-desai"
    },
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "A new cassette on a worn chain skips exactly like this. Measure the chain with a wear gauge, and replace it if it reads 0.75% or more. If the chain is fine, turn the rear derailleur's barrel adjuster a quarter turn at a time until the skipping stops.",
      "author": {
        "@type": "Person",
        "name": "Marco Bellini",
        "url": "https://spokesforum.example/users/marco-bellini"
      },
      "url": "https://spokesforum.example/questions/2291/chain-skips-smallest-cog#answer-5310",
      "upvoteCount": 24,
      "datePublished": "2026-08-02T19:05-07:00"
    },
    "suggestedAnswer": [
      {
        "@type": "Answer",
        "text": "Look at the derailleur hanger too. A bent hanger upsets the top gears first, and a shop can straighten it in a few minutes.",
        "author": {
          "@type": "Person",
          "name": "gravelgrace",
          "url": "https://spokesforum.example/users/gravelgrace"
        },
        "url": "https://spokesforum.example/questions/2291/chain-skips-smallest-cog#answer-5318",
        "upvoteCount": 6,
        "datePublished": "2026-08-03T07:42-07:00"
      }
    ]
  }
}

5 common mistakes

  1. Your own FAQ as a Q&A page. Questions your team wrote and answered, with nowhere for visitors to reply, are FAQ content. Google says not to use QAPage for FAQ pages.
  2. Several questions in one block. A product page where shoppers ask a dozen questions isn't a Q&A page in Google's sense. QAPage is for a page about one question.
  3. Counting only the answers in the form. If a thread has 40 answers and you mark up 10, Number of Answers is 40. Type the total yourself whenever the form doesn't hold every answer.
  4. An answer with no text. An author or votes in the Accepted Answer group without the answer itself writes an acceptedAnswer with no text, and the Generator lists Q&A under Not eligible yet.
  5. Replies that aren't answers. A reply asking which bike it is, or saying thanks, is a comment. Google wants those in the comment property, which this form doesn't write: keep them out of Other Answers, and add them to the copied code by hand if you want them.

How to test your QAPage markup

As you type, the Generator lists what the Q&A result still needs under Not eligible yet. Press Test in Google Rich Results to copy the code and open Google's test, paste it into the Code tab and check that Q&A is detected. Once your template prints the markup, test a live thread with an accepted answer and one with only other answers.

Frequently Asked Questions

Can I use QAPage markup on my FAQ page?

No. Google says not to use QAPage for FAQ pages or for pages with several questions. Those pages were what FAQPage is for, which the FAQ schema generator writes, but Google stopped showing the FAQ rich result on May 7, 2026.

What if nobody's answer was accepted?

Leave the Accepted Answer group empty and add every answer under Other Answers. Google requires an accepted answer or a suggested one; it doesn't need both.

What should Number of Answers say for a question with no answers yet?

Google allows 0, and the form writes 0 when the field is empty and there are no answers. Google also requires at least one answer, though, so the Generator shows Q&A as not eligible until someone replies. You can wait for the first reply before adding the markup.

Other schema generators