Google Discussion forum structured data

The Google DiscussionForumPosting guidance,
as documented

What Google documents, in its own words. Verified from Google's page on 2026-10-10.

Google's page explains which posts the markup is for and how to nest comments. This page lists those statements with the exact wording from Google.

What Google says

TopicWhat Google saysSource
Scope “Discussion forum markup is designed for any forum-style site where people collectively share first-hand perspectives.” Google docs
Verified 2026-10-10
Q&A forums “Does your forum follow a question and answer pattern? Use Q&A markup instead.” Google docs
Verified 2026-10-10
Comments “In general, we recommend nesting comments under the post they relate to.” Google docs
Verified 2026-10-10
Main entity “Don't mark one post on the page as a main entity if it's not a discussion page for the post.” Google docs
Verified 2026-10-10
User posts only “Only use DiscussionForumPosting markup to describe a user-generated post on a website.” Google docs
Verified 2026-10-10
Not for publishers “Don't use this markup for content that's primarily authored by the publishers of the website or their agents.” Google docs
Verified 2026-10-10
Social media “If your site is more like a generic social media platform, you can use SocialMediaPosting, which is the parent type of DiscussionForumPosting, with the same requirements.” Google docs
Verified 2026-10-10
Invalid: blog “An article or blog written directly by an agent for the website (even with comments)”Listed by Google as an invalid use case. Google docs
Verified 2026-10-10
Invalid: reviews “User reviews about a product”Listed by Google as an invalid use case. Google docs
Verified 2026-10-10
Full text “Make sure each DiscussionForumPosting includes the entire text of the post and make sure each Comment includes the entire text of the response if it's found on that page.” Google docs
Verified 2026-10-10
Format “Unlike our general structured data preference, we recommend providing the DiscussionForumPosting markup in Microdata (or RDFa) if possible.”Google adds that this is just a recommendation and JSON-LD is still fully supported. Google docs
Verified 2026-10-10
Content “To represent the content of the post, you must include one of the following properties:”Google lists text, image and video. Google docs
Verified 2026-10-10
Headline “If there isn't a separate title, don't duplicate or truncate the text into a headline.” Google docs
Verified 2026-10-10
Comment order “Mark up comments in the order in which they appear on the page.” Google docs
Verified 2026-10-10
Machine content “If this property is not specified, Google will assume the content is human-generated.”Said about digitalSourceType. Google docs
Verified 2026-10-10
Manual action “If you received a structured data manual action against your page, the structured data on the page will be ignored (although the page can still appear in Google Search results).” Google docs
Verified 2026-10-10
No guarantee “Google does not guarantee that features that consume structured data will show up in search results.” Google docs
Verified 2026-10-10

Read on 2026-10-10. Google's page showed "Last updated 2026-09-08 UTC". Notes under a quote are close paraphrases of the same page. This page covers only what Google documents.

How to apply it

A checklist built only from the guidance in Google's page.

  1. Check that the posts are user-generated and not written by the site's publishers.
  2. If the forum is mostly questions with answers, use Q&A markup instead.
  3. Include the entire text of each post and each comment found on the page.
  4. Nest comments under the post they relate to, in the order they appear.
  5. Give each post an author, a datePublished and one of text, image or video.
  6. Test with the Rich Results Test and the URL Inspection tool.

Related: Google QAPage structured data, Google ProfilePage structured data, Google structured data guidelines.

Questions

Can I use it on my company blog?

Google says not to use this markup for content that's primarily authored by the publishers of the website or their agents.

Should a question-and-answer forum use it?

Google says: "Does your forum follow a question and answer pattern? Use Q&A markup instead."

What is a post required to contain?

Google says to include one of text, image or video to represent the content of the post.

How current is this page?

Every quote was read from Google's page on 2026-10-10. The page showed "Last updated 2026-09-08 UTC". Google can change its documentation, so treat the linked page as the final word.

Sources

Let Balzac write the articles.

Type your website. Balzac finds the searches you can win, writes articles built to rank on Google and get cited by ChatGPT, and publishes them for you.

3 free articles · No card needed