S SCHEMA.BIZ
Content Extends: SocialMediaPosting

Discussion Forum Schema (DiscussionForumPosting)

Discussion forum schema marks up user-generated threads: a DiscussionForumPosting for the opening post, with its author, publication date and text, and Comment objects for the replies, nested the way the forum threads them. Google reads it on forums and community sites where users write the content, alongside counts of likes, views and replies. It isn't meant for articles a publisher writes, or for question-and-answer threads, which use QAPage.

Last updated:

Does Google show Discussion Forum schema?

Yes Google reads DiscussionForumPosting markup for this feature: Discussion forum.

  • Discussion forum Active

    Forum posts and their comments, from sites where users discuss topics.

    Last change in Google's documentation: March 24, 2026. Google documented more supported properties, such as threaded comments.

Last checked against Google's documentation: .

When to Use DiscussionForumPosting

Forum and message board threads Community and support discussion boards Posts on social and community platforms Comment threads on user-submitted content

What Google requires

schema.org defines 137 properties a DiscussionForumPosting can use, counting the ones it inherits. Google reads only a few of them for each feature; the rest are valid schema.org that Google doesn't require.

Discussion forum: 3 required, 3 recommended Google's documentation

Property Google schema.org expects
datePublished required Date, DateTime
author required Organization, Person
text required Text
url recommended URL
dateModified recommended Date, DateTime
interactionStatistic recommended InteractionCounter

DiscussionForumPosting properties

The properties that matter most in practice, of the 137 schema.org defines for DiscussionForumPosting. Status is our advice for a complete description; Google's own requirements are in the table above.

Property Type Status Description
author Person or Organization required Who wrote the post, with a name, and ideally a url to their profile page.
datePublished DateTime required When the post was made, in ISO 8601 with a time zone.
text Text required The full text of the post. Google needs text, image or video, unless the post links elsewhere with url.
image ImageObject or URL optional Images inline in the post. Not avatars, icons or a default image.
video VideoObject optional Videos inline in the post.
headline Text recommended The thread title. Leave it out when posts have no separate title.
url URL recommended The thread's canonical address; the first page of a multi-page thread.
dateModified DateTime recommended When the post was last edited. Not needed if it never was.
comment Comment recommended The replies, in page order, nested for threaded forums.
commentCount Integer recommended All replies, including those on other pages of the thread.
interactionStatistic InteractionCounter recommended Counts of likes, dislikes, views, replies or shares.
isPartOf CreativeWork or URL recommended The board, subforum or group the thread belongs to.
sharedContent CreativeWork recommended The main thing the post shares: a linked WebPage, an ImageObject, a VideoObject or another post.
creativeWorkStatus Text recommended "Deleted" for a removed post kept in the markup so the thread still makes sense.

JSON-LD Examples

Run your version through the schema.org validator to catch misspelled properties and invalid values before you publish.

Minimal:An opening post with author, date and text

What Google requires for a forum post: an author with a name, the publication date and time, and the text of the post.

{
  "@context": "https://schema.org",
  "@type": "DiscussionForumPosting",
  "author": {
    "@type": "Person",
    "name": "Priya Raman"
  },
  "datePublished": "2026-10-02T19:41:00-07:00",
  "text": "I picked up a 1940s No. 4 smoothing plane and the sole is out of flat by about 0.2 mm at the toe. Sandpaper on glass, or is it worth sending out for surface grinding?"
}

Complete:A thread with title, counts, board and a reply

A thread page with everything Google's forum documentation recommends: the canonical url, an edit date, the subforum in isPartOf, an inline image, like, view and reply counts, the author's profile link and post count, and the first reply as a Comment with its own url.

{
  "@context": "https://schema.org",
  "@type": "DiscussionForumPosting",
  "headline": "Flattening the sole of a vintage No. 4 plane",
  "text": "I picked up a 1940s No. 4 smoothing plane and the sole is out of flat by about 0.2 mm at the toe. Sandpaper on glass, or is it worth sending out for surface grinding?",
  "url": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/",
  "datePublished": "2026-10-02T19:41:00-07:00",
  "author": {
    "@type": "Person",
    "name": "Priya Raman",
    "url": "https://forum.example.com/members/priya-raman/",
    "agentInteractionStatistic": {
      "@type": "InteractionCounter",
      "interactionType": "https://schema.org/WriteAction",
      "userInteractionCount": 2416
    }
  },
  "dateModified": "2026-10-02T20:05:00-07:00",
  "image": "https://forum.example.com/attachments/no4-sole-straightedge.jpg",
  "isPartOf": "https://forum.example.com/boards/hand-tools/",
  "interactionStatistic": [
    {
      "@type": "InteractionCounter",
      "interactionType": "https://schema.org/LikeAction",
      "userInteractionCount": 34
    },
    {
      "@type": "InteractionCounter",
      "interactionType": "https://schema.org/ViewAction",
      "userInteractionCount": 1872
    },
    {
      "@type": "InteractionCounter",
      "interactionType": "https://schema.org/CommentAction",
      "userInteractionCount": 1
    }
  ],
  "commentCount": 1,
  "comment": {
    "@type": "Comment",
    "url": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/#post-512990",
    "author": {
      "@type": "Person",
      "name": "Tom Albrecht",
      "url": "https://forum.example.com/members/tom-albrecht/"
    },
    "datePublished": "2026-10-02T21:12:00-07:00",
    "text": "0.2 mm at the toe is fine for a smoother. Flatten just the toe, mouth and heel on 80 grit on glass and stop there.",
    "interactionStatistic": {
      "@type": "InteractionCounter",
      "interactionType": "https://schema.org/LikeAction",
      "userInteractionCount": 19
    }
  }
}

Real-world, nested:A threaded discussion with a shared link, a deleted reply and a bot

A real thread: the post shares a link (sharedContent), replies are nested under the reply they answer, a reply removed by a moderator stays in the tree with creativeWorkStatus Deleted, and an automated reply says so with digitalSourceType.

{
  "@context": "https://schema.org",
  "@type": "DiscussionForumPosting",
  "headline": "Flattening the sole of a vintage No. 4 plane",
  "text": "I picked up a 1940s No. 4 smoothing plane and the sole is out of flat by about 0.2 mm at the toe. Sandpaper on glass, or is it worth sending out for surface grinding?",
  "url": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/",
  "datePublished": "2026-10-02T19:41:00-07:00",
  "author": {
    "@type": "Person",
    "name": "Priya Raman",
    "url": "https://forum.example.com/members/priya-raman/"
  },
  "mainEntityOfPage": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/",
  "isPartOf": {
    "@type": "CollectionPage",
    "name": "Hand Tools",
    "url": "https://forum.example.com/boards/hand-tools/"
  },
  "sharedContent": {
    "@type": "WebPage",
    "url": "https://tools.example.org/guides/flattening-plane-soles/",
    "name": "Flattening a plane sole: how flat is flat enough?"
  },
  "interactionStatistic": {
    "@type": "InteractionCounter",
    "interactionType": "https://schema.org/LikeAction",
    "userInteractionCount": 34
  },
  "commentCount": 4,
  "comment": [
    {
      "@type": "Comment",
      "url": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/#post-512990",
      "author": {
        "@type": "Person",
        "name": "Tom Albrecht",
        "url": "https://forum.example.com/members/tom-albrecht/"
      },
      "datePublished": "2026-10-02T21:12:00-07:00",
      "text": "0.2 mm at the toe is fine for a smoother. Flatten just the toe, mouth and heel on 80 grit on glass and stop there.",
      "comment": [
        {
          "@type": "Comment",
          "url": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/#post-513004",
          "author": {
            "@type": "Person",
            "name": "Priya Raman",
            "url": "https://forum.example.com/members/priya-raman/"
          },
          "datePublished": "2026-10-02T21:40:00-07:00",
          "dateModified": "2026-10-02T21:46:00-07:00",
          "text": "Thanks, that saved me an afternoon. Do you lap with the frog in place?"
        },
        {
          "@type": "Comment",
          "url": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/#post-513011",
          "author": {
            "@type": "Person",
            "name": "woodbutcher_88",
            "url": "https://forum.example.com/members/woodbutcher-88/"
          },
          "datePublished": "2026-10-02T22:03:00-07:00",
          "text": "[Removed by a moderator]",
          "creativeWorkStatus": "Deleted"
        }
      ]
    },
    {
      "@type": "Comment",
      "url": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/#post-513020",
      "author": {
        "@type": "Organization",
        "name": "Workshop Helper Bot",
        "url": "https://forum.example.com/members/workshop-helper/"
      },
      "datePublished": "2026-10-02T22:10:00-07:00",
      "text": "Related threads: \"Lapping plates vs. glass\" and \"Which planes need a flat sole?\"",
      "digitalSourceType": "https://schema.org/AlgorithmicMediaDigitalSource"
    }
  ]
}

Common Discussion Forum schema mistakes

Giving the author as the bare username

AUTHOR_TEXT: schema.org accepts a plain name, but Google documents author as a Person or Organization object with a name, and ideally a url.

The object lets you add author.url, which Google recommends: a link to the member's profile page.

Wrong

{
  "@context": "https://schema.org",
  "@type": "DiscussionForumPosting",
  "headline": "Flattening the sole of a vintage No. 4 plane",
  "text": "I picked up a 1940s No. 4 smoothing plane and the sole is out of flat by about 0.2 mm at the toe. Sandpaper on glass, or is it worth sending out for surface grinding?",
  "url": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/",
  "datePublished": "2026-10-02T19:41:00-07:00",
  "author": "priya_r"
}

Right

{
  "@context": "https://schema.org",
  "@type": "DiscussionForumPosting",
  "headline": "Flattening the sole of a vintage No. 4 plane",
  "text": "I picked up a 1940s No. 4 smoothing plane and the sole is out of flat by about 0.2 mm at the toe. Sandpaper on glass, or is it worth sending out for surface grinding?",
  "url": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/",
  "datePublished": "2026-10-02T19:41:00-07:00",
  "author": {
    "@type": "Person",
    "name": "priya_r",
    "url": "https://forum.example.com/members/priya-raman/"
  }
}

A reply whose author has a profile link but no name

AUTHOR_NO_NAME: Google reads the author's name from author.name, so an author object needs one.

Google's requirements apply to each Comment as well as to the post: author with a name, datePublished, and text, image or video.

Wrong

{
  "@context": "https://schema.org",
  "@type": "DiscussionForumPosting",
  "headline": "Flattening the sole of a vintage No. 4 plane",
  "text": "I picked up a 1940s No. 4 smoothing plane and the sole is out of flat by about 0.2 mm at the toe. Sandpaper on glass, or is it worth sending out for surface grinding?",
  "url": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/",
  "datePublished": "2026-10-02T19:41:00-07:00",
  "author": {
    "@type": "Person",
    "name": "Priya Raman",
    "url": "https://forum.example.com/members/priya-raman/"
  },
  "comment": {
    "@type": "Comment",
    "author": {
      "@type": "Person",
      "url": "https://forum.example.com/members/tom-albrecht/"
    },
    "datePublished": "2026-10-02T21:12:00-07:00",
    "text": "Flatten the toe, mouth and heel and stop there."
  }
}

Right

{
  "@context": "https://schema.org",
  "@type": "DiscussionForumPosting",
  "headline": "Flattening the sole of a vintage No. 4 plane",
  "text": "I picked up a 1940s No. 4 smoothing plane and the sole is out of flat by about 0.2 mm at the toe. Sandpaper on glass, or is it worth sending out for surface grinding?",
  "url": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/",
  "datePublished": "2026-10-02T19:41:00-07:00",
  "author": {
    "@type": "Person",
    "name": "Priya Raman",
    "url": "https://forum.example.com/members/priya-raman/"
  },
  "comment": {
    "@type": "Comment",
    "author": {
      "@type": "Person",
      "name": "Tom Albrecht",
      "url": "https://forum.example.com/members/tom-albrecht/"
    },
    "datePublished": "2026-10-02T21:12:00-07:00",
    "text": "Flatten the toe, mouth and heel and stop there."
  }
}

Replies marked up without their dates

REQ_MISSING: Google requires this property for the search feature. Without it the page isn't eligible for that rich result, although the markup is still valid schema.org.

Wrong

{
  "@context": "https://schema.org",
  "@type": "DiscussionForumPosting",
  "headline": "Flattening the sole of a vintage No. 4 plane",
  "text": "I picked up a 1940s No. 4 smoothing plane and the sole is out of flat by about 0.2 mm at the toe. Sandpaper on glass, or is it worth sending out for surface grinding?",
  "url": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/",
  "datePublished": "2026-10-02T19:41:00-07:00",
  "author": {
    "@type": "Person",
    "name": "Priya Raman",
    "url": "https://forum.example.com/members/priya-raman/"
  },
  "comment": {
    "@type": "Comment",
    "author": {
      "@type": "Person",
      "name": "Tom Albrecht"
    },
    "text": "Flatten the toe, mouth and heel and stop there."
  }
}

Right

{
  "@context": "https://schema.org",
  "@type": "DiscussionForumPosting",
  "headline": "Flattening the sole of a vintage No. 4 plane",
  "text": "I picked up a 1940s No. 4 smoothing plane and the sole is out of flat by about 0.2 mm at the toe. Sandpaper on glass, or is it worth sending out for surface grinding?",
  "url": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/",
  "datePublished": "2026-10-02T19:41:00-07:00",
  "author": {
    "@type": "Person",
    "name": "Priya Raman",
    "url": "https://forum.example.com/members/priya-raman/"
  },
  "comment": {
    "@type": "Comment",
    "author": {
      "@type": "Person",
      "name": "Tom Albrecht"
    },
    "datePublished": "2026-10-02T21:12:00-07:00",
    "text": "Flatten the toe, mouth and heel and stop there."
  }
}

Copying the relative date the page shows ("2 hours ago")

VALUE_DATE: Dates and times must be ISO 8601: 2026-03-14 for a date, 09:00 for a time of day (24-hour), 2026-03-14T09:00:00-04:00 for a date and time. Other formats, and dates that don't exist, can't be read reliably.

Render the stored timestamp, with its time zone offset, not the friendly text the template prints.

Wrong

{
  "@context": "https://schema.org",
  "@type": "DiscussionForumPosting",
  "headline": "Flattening the sole of a vintage No. 4 plane",
  "text": "I picked up a 1940s No. 4 smoothing plane and the sole is out of flat by about 0.2 mm at the toe. Sandpaper on glass, or is it worth sending out for surface grinding?",
  "url": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/",
  "datePublished": "2 hours ago",
  "author": {
    "@type": "Person",
    "name": "Priya Raman",
    "url": "https://forum.example.com/members/priya-raman/"
  }
}

Right

{
  "@context": "https://schema.org",
  "@type": "DiscussionForumPosting",
  "headline": "Flattening the sole of a vintage No. 4 plane",
  "text": "I picked up a 1940s No. 4 smoothing plane and the sole is out of flat by about 0.2 mm at the toe. Sandpaper on glass, or is it worth sending out for surface grinding?",
  "url": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/",
  "datePublished": "2026-10-02T19:41:00-07:00",
  "author": {
    "@type": "Person",
    "name": "Priya Raman",
    "url": "https://forum.example.com/members/priya-raman/"
  }
}

Nested replies without @type Comment

TYPE_MISSING_NESTED: Nested objects should say what they are too. Without an @type, search engines have to guess, and Google's features may not recognise the object.

Wrong

{
  "@context": "https://schema.org",
  "@type": "DiscussionForumPosting",
  "headline": "Flattening the sole of a vintage No. 4 plane",
  "text": "I picked up a 1940s No. 4 smoothing plane and the sole is out of flat by about 0.2 mm at the toe. Sandpaper on glass, or is it worth sending out for surface grinding?",
  "url": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/",
  "datePublished": "2026-10-02T19:41:00-07:00",
  "author": {
    "@type": "Person",
    "name": "Priya Raman",
    "url": "https://forum.example.com/members/priya-raman/"
  },
  "comment": {
    "author": {
      "@type": "Person",
      "name": "Tom Albrecht"
    },
    "datePublished": "2026-10-02T21:12:00-07:00",
    "text": "Flatten the toe, mouth and heel and stop there."
  }
}

Right

{
  "@context": "https://schema.org",
  "@type": "DiscussionForumPosting",
  "headline": "Flattening the sole of a vintage No. 4 plane",
  "text": "I picked up a 1940s No. 4 smoothing plane and the sole is out of flat by about 0.2 mm at the toe. Sandpaper on glass, or is it worth sending out for surface grinding?",
  "url": "https://forum.example.com/threads/flattening-a-no-4-sole.48213/",
  "datePublished": "2026-10-02T19:41:00-07:00",
  "author": {
    "@type": "Person",
    "name": "Priya Raman",
    "url": "https://forum.example.com/members/priya-raman/"
  },
  "comment": {
    "@type": "Comment",
    "author": {
      "@type": "Person",
      "name": "Tom Albrecht"
    },
    "datePublished": "2026-10-02T21:12:00-07:00",
    "text": "Flatten the toe, mouth and heel and stop there."
  }
}

Also watch for

  • Marking up articles, blog posts or product reviews the site itself writes as DiscussionForumPosting. Google limits the type to user-generated posts; publisher content is an Article or BlogPosting, which can still carry user comments.

  • Using DiscussionForumPosting for a thread that is one question with answers. Google's forum documentation points those to QAPage.

  • Marking up only the first lines of a post, or truncating the text into headline. Google asks for the entire text of each post, and a headline only when the post has a real title.

  • Marking one post as the page's main entity on a board or topic list page. Only a thread's own discussion page has a main post.

Forum post, social post, Q&A or article

Google's forum documentation separates four cases. A post users write on a forum is a DiscussionForumPosting. A post on a general social platform can use its parent type, SocialMediaPosting, with the same requirements. A thread that's mostly a question and its answers is a QAPage with a Question. Content mainly written by the site's publisher or its agents, a staff blog post or an editorial review, is an Article or BlogPosting, even when readers comment under it.

Many forums mix these. A support community may have discussion boards and a Q&A board where answers can be accepted; use DiscussionForumPosting on the first and QAPage on the second, decided per board in the thread template. An announcement thread posted by staff on a forum is still a forum post if members reply in the same thread, but a news section that only staff can write in is an Article section.

The opening post and the replies are different types: the thread starts with one DiscussionForumPosting, and every reply under it is a Comment. Don't make each reply a DiscussionForumPosting of its own.

Threaded and flat replies, and long threads

Nest the markup the way the forum shows the conversation. In a threaded forum, a reply to a reply goes in the comment property of the Comment it answers, building a tree. In a linear forum, where every reply appears one after another, put all of them directly in the opening post's comment, in page order. Give each Comment its own url, a link to that reply such as the thread URL plus #post-512990, and leave it out if all you have is the thread's address.

Threads that run over several pages need care. On every page, include the opening post with the thread's url set to the first page, and mark up the replies shown on that page. Set commentCount to the total number of replies in the thread, so the count is right even though each page carries only some of them.

Keep the counts consistent with each other and with the page: if interactionStatistic has a CommentAction or ReplyAction count, it should match commentCount, and both should match the number the page displays.

Google asks for comments in the order they appear on the page. If readers can re-sort a thread by votes or newest first, generate the markup from the default order the server renders, not from a sort applied later in the browser. Replies that only load after a click ("Show 12 more replies") can be left out, as long as commentCount still gives the total.

Edits, deletions, bots and shared links

dateModified goes on a post or reply that was edited after posting; leave it out otherwise. When a moderator or the author deletes a reply that others answered, keep it in the markup with creativeWorkStatus set to Deleted, so the nested replies still have a parent, and use whatever placeholder text the page shows.

digitalSourceType says when content wasn't written by a person: https://schema.org/TrainedAlgorithmicMediaDigitalSource for text from a trained model such as an LLM, and https://schema.org/AlgorithmicMediaDigitalSource for simpler automation such as a reply bot. Without it, Google assumes a human wrote the post.

sharedContent is the main thing a post shares: a WebPage for a link, an ImageObject, a VideoObject, or a reference to another DiscussionForumPosting or Comment for a quoted or crossposted one. Use image and video only for media inline in the post, not for avatars, signatures or a default thumbnail.

Microdata, list pages and testing

Unusually, Google recommends Microdata or RDFa for forum markup where possible: the post text is already in the HTML, so attributes on the existing elements avoid copying long threads into a JSON-LD block. JSON-LD is still supported, and it's often easier to generate from a forum's API; if you use it, make sure it contains the full text of every post you mark up.

On a thread page, the opening post is the page's subject: point to it with mainEntityOfPage on the post or mainEntity on a WebPage. Board, tag and profile pages that list many threads have no main post; mark up only what each list entry shows (title, author, date, reply count), and group the entries in an ItemList or Collection.

To check a thread template, paste the output into the Validator at /markup/validator/, which applies Google's requirements to the post and to every Comment. Test a thread with nested replies, an edited post and a deleted reply, since those exercise the template's conditional fields. Google's Rich Results Test reads the live page.

Complete Guide to Discussion Forum Schema

Google reads discussion forum markup for its forum and discussion results, which show content from sites where people talk about a topic first-hand. It requires an author with a name, a datePublished, and the post's text, image or video; a post that represents a post on another page can rely on its url instead. The same rules apply to each Comment in the thread. The type sits under SocialMediaPosting, which in turn is an Article subtype, but Google checks it against its forum requirements, not its Article ones.

On 2026-03-24 Google documented more supported properties for forum and Q&A markup, such as threaded comments. Its forum documentation now lists, among others, nested comment trees, creativeWorkStatus for deleted posts, digitalSourceType for machine-generated replies, sharedContent, isPartOf for the board a thread belongs to, and counts on each reply. None of them is required, but they let the markup describe a real thread rather than a flattened copy of it.

The author link connects forum markup to ProfilePage. Each author's url should be the member's profile page, and that page's ProfilePage markup describes the member once, with their handle and post count. Together they let search engines tell which posts belong to which member without repeating the profile in every thread.

Give every date a time zone: 2026-10-02T19:41:00-07:00, not a bare local time. Forums are read across time zones, and relative dates ("yesterday") or dates without an offset can be read hours or a day off.

Where DiscussionForumPosting sits in schema.org

"A posting to a discussion forum."

Path from Thing: Thing CreativeWork Article SocialMediaPosting DiscussionForumPosting

Parent type
SocialMediaPosting
More specific types
None: DiscussionForumPosting has no subtypes in schema.org.

Related Types

Ready to Create DiscussionForumPosting Markup?

Use our free generator to create valid DiscussionForumPosting JSON-LD markup with a visual form. No coding required.

Open Generator