Generate valid DiscussionForumPosting JSON-LD structured data for forum threads and community posts. Help Google surface your discussions in search with proper post, author, and engagement markup.
OneStepToRank monitors your structured data in production, alerts you when schema breaks, and tracks how your rich results change over time.
Get StartedDiscussion Forum schema (DiscussionForumPosting) is structured data markup that tells search engines a page contains community discussion content. Built on the Schema.org DiscussionForumPosting type, it provides machine-readable details about forum posts: the title, body text, author, publication date, comment count, and upvote statistics. When Google reads this markup, it can display your forum threads in the Discussions and Forums search filter and in enhanced SERP snippets showing engagement metrics directly in results.
Without this structured data, Google must infer that your content is a discussion thread from page layout and content patterns. Adding explicit markup removes ambiguity and increases the likelihood that your forum posts receive rich result treatment, driving more targeted traffic from users who are actively seeking community discussions and answers.
Forum content competes with polished editorial articles in search results. Structured data gives discussion threads a distinct visual identity. Posts with DiscussionForumPosting schema can display author names, comment counts, and upvote statistics directly in the SERP, signaling to users that the result contains real community discussion rather than marketing content. Google introduced the Discussions and Forums search filter specifically to surface community-generated content, and pages with proper forum schema are more likely to appear in this dedicated section.
Engagement metrics like comment count and upvotes serve as social proof in search results. A forum post showing "45 upvotes, 12 replies" immediately communicates that the community found this content valuable, increasing click-through rates compared to results without these signals. This is especially powerful for long-tail queries where users want real-world experiences and opinions rather than generic articles.
For custom-built forums, paste the generated JSON-LD script into your thread template's <head> section. Use your templating engine to dynamically populate fields from your database: thread title, author username, post date, reply count, and vote totals. Each thread page should have its own DiscussionForumPosting schema with the isPartOf property linking back to the parent forum.
For WordPress forums using bbPress or BuddyPress, add the JSON-LD to your topic template file. bbPress stores reply counts and author data that can be injected into the schema using WordPress functions. If you use a page builder or forum plugin that supports custom code blocks, paste the script tag into the topic display template.
For Discourse, phpBB, or vBulletin, modify the topic template to include the generated schema. Most modern forum platforms provide template customization where you can inject structured data into the page head. Use platform-specific template variables to populate the author, date, reply count, and vote fields dynamically.
After deployment, always validate your live pages with the Rich Results Test and monitor the Enhancements section in Google Search Console for ongoing issues. Combine this with our Local Rank Checker to track how structured data affects your visibility.
DiscussionForumPosting schema is structured data you add to forum or community pages to help search engines understand the content is a discussion thread. It uses the Schema.org DiscussionForumPosting type encoded in JSON-LD format, providing machine-readable details like post title, body text, author, publication date, comment count, and upvote statistics. This enables Google to display forum posts with enhanced snippets and in the Discussions and Forums search filter.
When Google detects valid DiscussionForumPosting schema, it can display your forum content with enhanced visual treatment in search results. This includes showing post titles, author names, dates, comment counts, and upvote statistics directly in the SERP. Forum posts with this markup are more likely to appear in Google's Discussions and Forums filter, which surfaces community-generated content to users seeking real-world experiences and opinions.
Yes. DiscussionForumPosting is designed for any community discussion platform including Reddit-style forums, traditional bulletin boards, Q&A sites, and comment sections. If your content involves user-generated posts with replies and upvotes, this schema type is appropriate. For pure question-and-answer content with one accepted answer, you might also consider QAPage schema, but DiscussionForumPosting works well for open-ended discussions.
Google recommends including commentCount to show how many replies a post has, and InteractionCounter with LikeAction (upvotes) to indicate community engagement. These metrics help Google understand the popularity and relevance of forum content. Posts with higher engagement metrics may receive preferential treatment in search results. You can also include viewCount using InteractionCounter with ViewAction if your forum tracks page views.