Discussion Forum Structured Data Guide
Want Google to show reply counts for your forum thread? DiscussionForumPosting structured data marks a page as a real conversation, which is what unlocks the reply count and participant details in the result. Add the markup to the original post and replies, preview it with the free Structured Data Preview tool, and check Google's Discussion Forum documentation for the full requirements.



What is Discussion Forum structured data?
Discussion Forum structured data describes a conversation page: a question someone asked, the answers people gave, and who wrote what. It is the markup behind the threaded discussion results you see for community sites, Q&A forums and support threads. When Google recognizes a page as a real discussion, it can show the number of replies, the people involved and sometimes the top answer, which makes the result look active rather than abandoned. For the full property list and examples, see Google's Discussion Forum structured data documentation.
The main type is DiscussionForumPosting, and a discussion is really a collection of these. The original post carries the headline, the text, the author and the date, and each reply is another DiscussionForumPosting linked through the page's structure. The related QAPage type is for question-and-answer pages where one answer is accepted, and it is worth knowing the difference: a forum thread is a conversation, while a Q&A page has a single best answer. Using the wrong one sends Google the wrong signal.
This markup fits community forums, product support boards, hobby sites with threads, and any page where the content is a conversation with multiple participants. It does not fit a one-way article, even if that article has a comment section, because the value is in the back-and-forth. If your page is mostly your own writing with a few comments bolted on, you likely want Article instead. Google also expects genuine user contributions, so thin or seeded discussions tend not to earn the rich treatment.
What it looks like in search results
A marked-up discussion can appear with the headline, a snippet of the conversation, the number of replies and sometimes the participants. The exact layout varies by query and device, and Google often shows a condensed form rather than a full thread. Because presentation changes frequently, the real appearance may differ from any example you have seen. Verify your page in the Rich Results Test and preview the structure with the Structured Data Preview tool.
JSON-LD example
{
"@context": "https://schema.org",
"@type": "DiscussionForumPosting",
"headline": "Why does my sourdough starter smell like nail polish remover?",
"author": {
"@type": "Person",
"name": "riverside_baker"
},
"datePublished": "2026-10-30T09:20:00-07:00",
"text": "My starter is three weeks old and has a sharp acetone smell. Is it dead or just hungry?",
"interactionStatistic": {
"@type": "InteractionCounter",
"interactionType": "https://schema.org/ReplyAction",
"userInteractionCount": 14
},
"comment": [
{
"@type": "Comment",
"author": {
"@type": "Person",
"name": "crumb_chaser"
},
"text": "Sounds like it is hungry. Feed it twice a day for two days and it should settle down.",
"datePublished": "2026-10-30T11:05:00-07:00"
}
]
}
headline is the thread title, author and datePublished identify who started it and when, and text holds the opening post. The interactionStatistic with a ReplyAction tells Google how many replies there are, which is one of the signals it uses to judge whether a discussion is active. Each reply goes in comment as a Comment with its own author, text and date. Keep the order sensible and make sure the visible page matches what the markup describes.
Required and recommended properties
Google wants headline or text for the post, an author, and enough content for the page to read as a real discussion. A single post with no replies can still be valid, but it will not look like an active conversation, so the rich treatment is less likely. The interactionStatistic with a reply count is strongly recommended because it signals activity.
Recommended: datePublished for the original post, comment entries for each reply with authors and dates, and author objects that are real people or stable handles. Avoid using the site name as the author of every post; Google can tell when a "discussion" is really one editor posting under different names. Consistent dates and a visible reply count that matches the markup keep the page trustworthy.
How to add Discussion Forum markup to your page
1) Use the validator and select DiscussionForumPosting. 2) Fill in the headline, author, date and opening text, then add each reply as a comment. 3) Fix errors the preview flags, usually a missing author or a malformed reply count. 4) Paste the JSON-LD into the thread page <head>. 5) Test the live URL in the Rich Results Test and confirm Google detects the posting and the reply count.
Common mistakes to avoid
Marking up a Q&A page as a forum. If one answer is accepted and the page is a question with answers, use QAPage; a forum is a conversation with many voices.
Inventing replies. Seeded or fake comments to pad the count are exactly the kind of thing Google looks for and penalizes.
Reply count that does not match the page. If the markup says 14 replies and the page shows 2, the mismatch undermines trust.
Using the site name as author. Real discussions have real participants. A single admin posting under many names is not a discussion.
Missing dates. Without datePublished, the thread looks undated and less useful in results.
Headline that is just a category name. "General Discussion" tells no one what the thread is about.
Copying an article into forum markup. A one-way post with a comment box is not a discussion forum.
Stale threads presented as active. A five-year-old thread with no recent replies will not get the active-conversation treatment.
Frequently asked questions
What is the difference from QAPage? QAPage is for a single question with answers, often one accepted. DiscussionForumPosting is for an open conversation. Pick based on how the page actually works.
Do I need to mark up every reply? Not necessarily every one, but the more genuine replies you describe with authors and dates, the more complete the result. At minimum, describe the original post and the main replies.
Can a small forum use this? Yes, as long as the discussions are real and have actual participants. Size does not matter as much as authenticity.
Does it help with rankings? It can help Google understand and display the conversation, which may improve click-through. It is not a direct ranking boost.
Related guides
Try it on your own content
The Structured Data Preview checks content against these practices in seconds. Free and no sign-up; see the tool page for how analysis works.