Last updated:
Discussion Forum Schema Generator
This discussion forum schema generator writes DiscussionForumPosting JSON-LD for one thread on your site: the opening post, who wrote it and when, its likes and views, and the replies under it. Fill in the post, add each reply in the order the page shows it, then paste the script tag into the thread's page.
Reference: Discussion Forum schema
Forum Post: Use on a forum thread or social post written by your site's users, with its replies. For a thread that's a question with answers, use Q&A Page instead; for your own articles, use Article.
What Google shows for Discussion Forum markup
- Discussion forum: shown in Google Search; Google's last documented change was on March 24, 2026.
Google uses this markup to show forum posts and their comments from sites where users discuss topics. It's only for posts your users write: content written mainly by the site's own publishers doesn't qualify, and neither do articles or product reviews. Valid markup makes a thread eligible; Google decides what it shows.
Google requires an author with a name, the date and time of posting in ISO 8601, and text, an image or a video, for the post and for each reply. If your forum is mostly questions and their answers, Google recommends Q&A markup instead, which the QAPage schema generator writes.
How to fill in each field
Post
Title is the thread title the page shows; if your posts have none, leave it empty rather than copying the opening words. Post Text is the whole post, not a preview. Thread URL is the discussion's canonical address, and Subforum URL fills isPartOf with the board the thread sits in. Image URL is only for a picture inside the post.
Fill in Last Edited only if the post was edited. Time Zone (UTC offset) is added to every date in the form, the replies' included: enter the forum's offset once, such as -05:00, or Z for UTC.
Author
Author Name is the name or username shown next to the post, written as a Person. Google also accepts an Organization; for a company account, change the @type in the copied code. Author Profile URL is the member's profile page on your forum.
Statistics
Likes and Views become interactionStatistic counters: a LikeAction for likes or upvotes, a ViewAction for views. Number of Replies is commentCount, the thread's total. Use the numbers the page displays. Google also lists dislike and share counters, which the form doesn't write.
Replies
Press + Add Reply once per reply, in page order. Each needs Author Name, Posted On and Reply Text. A reply's Posted On is a date and time picker, like the post's, and gets the same time zone. Reply URL links to that reply, such as the thread address with its anchor; leave it empty if it would only point to the thread.
The form writes replies flat under the post. Google's documentation now covers threaded comments: on a threaded forum, move each reply into the comment of the one it answers in the copied code.
The form marks 3 fields as required and 6 as recommended:
- Post Text (required): The post itself, as the page shows it. Google needs text, an image or a video.
- Posted On (required): When the post was made.
- Author Name (required): The poster's name or username, as the page shows it.
- Title (recommended): The post's title. If the post has none, leave it empty rather than copying the start of the text.
- Thread URL (recommended): The discussion's canonical URL.
- Time Zone (UTC offset) (recommended): Added to every date in this form: an offset such as -05:00, or Z for UTC.
- Author Profile URL (recommended): The poster's profile page on your site.
- Number of Replies (recommended): All the thread's replies, which can be more than you mark up below.
- Replies (recommended): Replies in the order the page shows them. Each needs its author, date and text.
Example: A gardening thread with three replies
A member's question in a vegetables subforum: an edited post with a photo, its counts, and three replies with their own links.
{
"@context": "https://schema.org",
"@type": "DiscussionForumPosting",
"headline": "Tomato leaves curling a week after transplanting",
"text": "I moved six Brandywine seedlings into raised beds last Saturday and the lower leaves have started curling upward. No spots, and the soil is damp. Transplant shock, or something to worry about?",
"url": "https://growfolk.example/forum/vegetables/tomato-leaves-curling",
"image": "https://growfolk.example/forum/uploads/brandywine-leaves.jpg",
"datePublished": "2026-05-16T08:12-05:00",
"dateModified": "2026-05-16T08:30-05:00",
"isPartOf": "https://growfolk.example/forum/vegetables",
"author": {
"@type": "Person",
"name": "raisedbed_rosa",
"url": "https://growfolk.example/members/raisedbed_rosa"
},
"interactionStatistic": [
{
"@type": "InteractionCounter",
"interactionType": "https://schema.org/LikeAction",
"userInteractionCount": 9
},
{
"@type": "InteractionCounter",
"interactionType": "https://schema.org/ViewAction",
"userInteractionCount": 640
}
],
"commentCount": 3,
"comment": [
{
"@type": "Comment",
"author": {
"@type": "Person",
"name": "old_mill_garden",
"url": "https://growfolk.example/members/old_mill_garden"
},
"datePublished": "2026-05-16T09:05-05:00",
"text": "Upward curl on the lower leaves with no spots is usually stress from wind or a cold night. Give them a week before you change anything.",
"url": "https://growfolk.example/forum/vegetables/tomato-leaves-curling#reply-2"
},
{
"@type": "Comment",
"author": {
"@type": "Person",
"name": "kale_and_hearty",
"url": "https://growfolk.example/members/kale_and_hearty"
},
"datePublished": "2026-05-16T12:40-05:00",
"text": "Same thing happened to mine in April. A shade cloth for the first few afternoons sorted it out.",
"url": "https://growfolk.example/forum/vegetables/tomato-leaves-curling#reply-3"
},
{
"@type": "Comment",
"author": {
"@type": "Person",
"name": "raisedbed_rosa",
"url": "https://growfolk.example/members/raisedbed_rosa"
},
"datePublished": "2026-05-18T18:22-05:00",
"text": "Update: two warm days later the new growth looks normal. Thanks, both of you.",
"url": "https://growfolk.example/forum/vegetables/tomato-leaves-curling#reply-4"
}
]
} 5 common mistakes
- Staff articles marked up as forum posts. A guide your own team wrote isn't a user's post, even with comments below it. Use the article schema generator.
- A question-and-answer board as a forum. When threads are a question followed by answers, Google recommends Q&A markup for them.
- A title made from the first words of the post. If posts have no title of their own, leave Title empty instead of trimming the text into one.
- An avatar or a stock picture as the image. A profile photo, a forum logo or a placeholder isn't part of the post. Leave Image URL empty.
- A reply count that only counts what's marked up. If the thread has 40 replies and you add 10, Number of Replies is still 40.
How to test your Discussion Forum markup
While you type, the Generator lists missing required fields and, under Not eligible yet, says what the post or a reply still needs. Press Test in Google Rich Results to copy the code and open Google's test, then paste it into its Code tab. Once the template is live, test a real thread with several replies, or check it in the Schema Validator.
- Open the example in the Schema Validator, which checks it against schema.org and Google's requirements.
- Preview the example in the SERP Simulator to see which search enhancements it can earn.
- Read the discussion forum schema reference for the type's other properties and more examples.
Frequently Asked Questions
Do I have to mark up every reply in a thread?
No. Mark up the replies the page shows, in page order, and set Number of Replies to the total. Google recommends commentCount for when not every comment is in the markup.
Can I use this form for comments under my blog posts?
No. A blog post your site publishes is publisher content, which Google excludes from forum markup, even with reader comments. Use Article or BlogPosting markup for it.
How do I mark up a post that was deleted?
Google recommends keeping a removed post that the thread needs for context, with creativeWorkStatus set to Deleted. The form has no field for it: add it to that post or reply in the copied code.
Other schema generators
- Local Business Schema Generator
- FAQ Schema Generator
- Product Schema Generator
- Organization Schema Generator
- Article Schema Generator
- Video Schema Generator
- Review Schema Generator
- Person Schema Generator
- Event Schema Generator
- Recipe Schema Generator
- Job Posting Schema Generator
- Course Schema Generator
- Software Application Schema Generator
- HowTo Schema Generator
- Breadcrumb Schema Generator
- Profile Page Schema Generator
- QAPage Schema Generator
- Course List Schema Generator
- JSON-LD Generator, with every form and the templates