What Is DiscussionForumPosting Schema? The Complete Guide (2026)

Why DiscussionForumPosting Schema Matters

Forum content is among the most heavily cited sources in AI search systems. Research published by Princeton and Georgia Tech (ACM KDD 2024) found that Reddit, StackOverflow, and similar community platforms are cited in AI-generated responses at far higher rates than brand-owned content on equivalent topics. Structured markup helps AI systems correctly attribute, date, and contextualize this content.

Google's Discussion Forum rich results documentation confirms that properly marked-up forum posts can appear with author information, post dates, and engagement counts directly in search results.

DiscussionForumPosting vs. SocialMediaPosting: What Is the Difference?

Greadme warns when headline is present on a SocialMediaPosting schema, and deducts 3 points. It is perfectly valid and recommended on DiscussionForumPosting.

Required Properties

Recommended Properties

interactionStatistic: Valid Types by Context

Greadme validates interactionType values strictly based on context. The two contexts have different allowed types:

Each InteractionCounter must include @type: "InteractionCounter", interactionType, and userInteractionCount. Greadme errors if userInteractionCount is missing.

DiscussionForumPosting Schema Code Example

A complete forum post with interactionStatistic and a nested comment:

{
  "@context": "https://schema.org",
  "@type": "DiscussionForumPosting",
  "url": "https://forum.example.com/post/123",
  "headline": "Best practices for caching API responses?",
  "text": "I'm building a REST API and wondering about caching strategies.",
  "datePublished": "2026-04-10T09:00:00+00:00",
  "dateModified": "2026-04-10T10:30:00+00:00",
  "author": {
    "@type": "Person",
    "name": "dev_jane",
    "url": "https://forum.example.com/user/dev_jane"
  },
  "interactionStatistic": [
    {
      "@type": "InteractionCounter",
      "interactionType": "https://schema.org/LikeAction",
      "userInteractionCount": 142
    },
    {
      "@type": "InteractionCounter",
      "interactionType": "https://schema.org/CommentAction",
      "userInteractionCount": 38
    }
  ],
  "comment": [
    {
      "@type": "Comment",
      "text": "Redis with a TTL strategy works well for most cases.",
      "datePublished": "2026-04-10T09:45:00+00:00",
      "author": {
        "@type": "Person",
        "name": "backend_guru",
        "url": "https://forum.example.com/user/backend_guru"
      }
    }
  ]
}

The Content Guideline: User-Generated Only

DiscussionForumPosting must only be used for genuinely user-generated content. Posts authored by a publisher or their agents — including official company announcements posted on a forum — should not be marked up as DiscussionForumPosting.

Greadme always includes a content-guideline advisory warning to remind you of this requirement. Misuse (e.g., marking up brand-authored content as forum posts) violates Google's structured data guidelines and may result in manual actions.

Common Mistakes to Avoid

• Missing datePublished time and timezone: Greadme recommends using the full datetime format: "2026-04-10T09:00:00+00:00". A date-only value like "2026-04-10" is valid ISO 8601, but Greadme prefers the full format for maximum precision in time-sensitive content.
• Using headline on SocialMediaPosting: Greadme warns and deducts 3 points. Social media posts do not have separate titles — do not add a headline.
• creativeWorkStatus with anything other than "Deleted": This is the only valid value. Any other value triggers a Greadme warning.
• Missing url on comments: Comment objects should have a url property pointing to an anchor link for that specific comment (e.g., https://forum.example.com/post/123#comment-456).
• Using FollowAction in content interactionStatistic: FollowAction belongs in agentInteractionStatistic on the author object, not in the post-level interactionStatistic. Greadme warns on invalid type usage.

How Greadme Validates DiscussionForumPosting Schema

Greadme validates both DiscussionForumPosting and SocialMediaPosting schemas with type-aware rules. Score starts at 100:

Frequently Asked Questions