--- title: "Add a TL;DR and FAQ to a post" url: "https://mycommunitysync.com/post-tldr-and-faq" community: "CommunitySync" description: "Give any post a short summary callout and an FAQ accordion — readers get the gist at a glance, and the Q&A is marked up so AI search can quote it." updated: "2026-07-22T15:53:30.801+00:00" --- # Add a TL;DR and FAQ to a post *Website Content & Blog* Every post in a collection — a blog post, a case study, a resource guide — can carry two extras on top of its article body: a **TL;DR** (a two-to-three-sentence summary shown in a callout near the top) and an **FAQ** (a question-and-answer accordion). Both are written once in the post editor and placed on the rendered page automatically, so you never touch the design. The FAQ is also emitted as machine-readable **FAQPage** markup, which is what lets AI search tools quote your answers — see [Where FAQ schema works today](/faq-schema-where-it-works) for why that matters. ## Who can do this Posts are edited by community **owners** and **admins** in the orange platform panel, same as the rest of the CMS. If you're new to the entry workflow, start with [Add and edit entries in a collection](/manage-cms-entries). ## Open the TL;DR & FAQ tab 1. In the orange platform panel, go to **Website**, open the CMS, and select the post. 2. Click the **TL;DR & FAQ** tab in the post editor. The tab holds a TL;DR text box, the FAQ list, and two buttons: **Generate from article** and **Find content gaps**. ## Write the TL;DR The TL;DR is a two-to-three-sentence plain-language summary of the post. Type it into the **TL;DR** box, or click **Generate from article** to have AI draft it from the post's own text — see [Generate a post's TL;DR and FAQ with AI](/generate-tldr-faq-with-ai). On the rendered post it appears as a callout titled **TL;DR** near the top — right under the header or hero when the template has one — so a skimming reader gets the takeaway before deciding to read on. ## Build the FAQ Each FAQ item is a question with a short answer. You can build the list three ways, and mix them freely: - **Generate from article** — AI drafts a set of Q&As grounded in what the post actually says. - **Find content gaps** — pulls in questions people really search for that the post doesn't answer yet; you write the answers. See [Find content gaps with live search demand](/find-content-gaps). - **Add question** — write a question and answer by hand. Remove a single item with its **×**, or use **Clear FAQ** to drop the whole list. ## How they appear on the post You don't place these anywhere — the renderer does it for you: - The **TL;DR** callout goes near the top of the post, under the header/hero. - The **FAQ** depends on the template. If the template's layout already includes a designed FAQ section, your post's questions **replace that section's questions on this post** — its position, heading, and styling stay. If the template has no FAQ section, the post gets its own accordion titled **Frequently asked questions** at the bottom of the article, above the footer. If you **Clear FAQ** on a post whose template has a designed FAQ section, that section's own questions come back. ## The FAQ is also machine-readable Whenever a post has an FAQ, the page automatically emits **FAQPage** structured data — and it always matches exactly the Q&A a visitor sees on the page, never something invisible. There is no separate schema step and nothing to keep in sync. Curious what structured data is? See [What is schema markup](/what-is-schema-markup). ## Save and publish The TL;DR and FAQ save with the rest of the post: - **Save draft** keeps your work without changing the live post. - **Publish** pushes everything live — the callout, the accordion, and the updated markup. ## Troubleshooting ### My TL;DR or FAQ isn't showing on the live post They only reach the public site when the post itself is published — and a published post also needs its template's layout published and the site live. Work through the three conditions in [Add and edit entries in a collection](/manage-cms-entries), then allow a few minutes for the site cache. ### The template's FAQ questions disappeared from my post That's the replacement rule: once a post has its own FAQ, it takes over the designed FAQ section's slot on that post. Use **Clear FAQ** to fall back to the section's own questions. ### A question I added is missing from the accordion Only items with **both** a question and an answer are kept when the post saves — a row with a blank answer (for example, one just added from content gaps) is dropped. Write the answer, then save again. ### Website Content & Blog - [Content collections explained (templates & entries)](https://mycommunitysync.com/cms-collections-overview.md) - [Add and edit entries in a collection](https://mycommunitysync.com/manage-cms-entries.md) - [Add a blog to your website](https://mycommunitysync.com/add-a-blog.md) - [Build a help or resource center](https://mycommunitysync.com/build-a-resource-center.md) - [Generate a post's TL;DR and FAQ with AI](https://mycommunitysync.com/generate-tldr-faq-with-ai.md) - [Find content gaps with live search demand](https://mycommunitysync.com/find-content-gaps.md) - [Set a post's search snippet and share preview](https://mycommunitysync.com/post-seo-search-and-social.md)