--- title: Docs slug: docs description: Manage docs entries with revisions, preview, and publish state. productSlug: cedros productLabel: Cedros sectionKey: site sectionLabel: Site --- # Docs The Docs section is where you manage every documentation article on your site — getting-started guides, how-tos, reference pages, install instructions. From here you can see every doc at a glance, check how each one is performing, and jump in to write, preview, or publish. Each doc lives at its own address under `/docs/` and is grouped by product and section so your help site builds a tidy sidebar on its own. ## What's on this page ### The docs library The main view is a table listing every doc on your site. Each row shows: - **Title** — The doc name, with a colored dot showing its status (Draft, Scheduled, Published, or Archived) and the address it lives at (for example, `docs/getting-started`). - **Views** — How many times the doc has been viewed. - **Visitors** — How many unique people viewed it. - **Views / visitor** — Average pages per visitor. - **Avg session** — Average time visitors spend reading. - **Exit rate** — Percentage of visits where this doc was the last page before leaving. - **CTA clicks** — How many times visitors clicked a call-to-action button in the doc. A dash (`—`) means analytics haven't loaded yet or no data has been recorded for that doc. ### Toolbar (top of the table) - **Search** — Type any part of a doc title or address to filter the list. The box reads "Find by title or slug". - **Status filter** — Narrow the list to Draft, Scheduled, Published, Archived, or All states. The **Type** filter is hidden here because everything in this section is a doc. Switch to Pages or Blogs for those content types. ### Row actions Hover over any row to see the action icons on the right. **View**, **Edit**, and **Delete** always appear; **Copy preview link** and **Analytics** show only when they apply, so the exact number of icons varies from row to row: - **View** (eye icon) — Open the doc in a new tab as visitors see it. - **Copy preview link** (copy icon) — Mints a shareable link so a teammate can review the draft without logging in. Only shown for unpublished drafts. - **Analytics** (chart icon) — Opens deeper analytics for this single doc (views over time, traffic sources, scroll depth, click heatmap, SEO health). See [Doc Analytics](doc-analytics.md). - **Edit** (pencil icon) — Opens the doc in the editor. See [Add / Edit a Doc](add-edit-doc.md). - **Delete** (trash icon) — Permanently removes the doc. You'll be asked to confirm. ### Header buttons At the top of the section: - **New Doc** — Starts a fresh doc in the editor. - **Upload docs** — Imports Markdown files (or a zip archive of Markdown files) as docs drafts. Anything missing from a file's front matter is filled in from the filename and body. When extensions provide ready-made starter articles, they appear as **Start Draft** cards you can use as a head start for a new doc. ## Common things you can do here ### Find a specific doc Type into the **Search** box. It matches against the title and the address, so searching `install` will find both an "Install" doc and any doc at `docs/install`. ### See what's performing best Click any analytics column header to sort. **Views** and **Visitors** show what's read most; **Avg session** flags the docs people actually finish; **Exit rate** highlights articles where readers stop and leave. ### Write a new doc Click **New Doc** in the top right. You'll go straight into the editor with an empty draft, where you give it a title, an address under `docs/`, and a body. See [Add / Edit a Doc](add-edit-doc.md) for the full walkthrough. ### Import existing docs in bulk Click **Upload docs** and choose one or more `.md` files, or a single `.zip` containing `.md` files. Each file becomes a docs draft. If a file includes front matter (product, section, and similar fields), those values are used; anything missing is inferred from the filename and body. ### Review a draft before publishing Open a draft, click **Copy preview link** in the row, and send it to a teammate. They'll see the unpublished doc in their browser without needing admin access. ### Dig into one doc's analytics Click the chart icon on the row. You'll see view trends, scroll depth, click heatmaps, top search queries, and on-page SEO checks — all for that single doc. See [Doc Analytics](doc-analytics.md). ## Tips - **Docs are organized by product and section.** Each doc carries a product and a section (such as "Getting Started"), and the public help site uses these to build its sidebar grouping. New docs start in the default section; to place a doc under a specific product or section, set those fields in its front matter and bring it in with **Upload docs**. See [Add / Edit a Doc](add-edit-doc.md). - **Categories and tags are optional.** Use a category for a high-level grouping when you need one, and tags to help search and badges. They don't replace the product/section sidebar structure. - **Nested addresses are supported.** A doc can live at a layered address like `docs/pay/getting-started/install`, which lets you mirror your product structure in the URL. - **Status dots are color-coded.** Hover any dot to see the label (Draft / Scheduled / Published / Archived). - **Scheduled docs show their publish date** beneath the title. - **Docs started by an extension** arrive as ordinary drafts that you own. They are yours to edit, publish, and delete like any other doc — unlike extension-owned *pages*, which are locked. - **Numbers reflect the current site-wide analytics window.** To dig deeper or change the window for a single doc, open that doc's Analytics view. - **Permissions matter.** If you don't have edit permission, the **Edit**, **Delete**, and publishing buttons are disabled (they show a "Requires data:pages:write" note when you hover) and the **New Doc** button is disabled. Ask an admin for the right access. ## Troubleshooting - **The list is empty?** A brand-new site shows "No docs have been created yet." Click **New Doc** or **Upload docs** to add your first article. - **Analytics columns are blank?** That's normal for a brand-new doc, or right after publishing. Numbers fill in once visitors read the doc and analytics finish processing. - **A doc won't delete?** Docs added by extensions are managed from the extension's own settings page, not here. - **Preview link doesn't work?** Preview links are tied to the draft revision. If you published or deleted the draft after sharing, the link expires. Generate a new one and reshare. - **Can't find a doc you know exists?** Check the **Status** filter — it might be Archived. Set it to **All states** to see everything. - **Buttons look disabled?** You likely don't have edit permission. Hover a disabled button to confirm, then ask an admin for **data:pages:write** access. Opening the media workspace from the editor also needs media read access; see [Media](media.md).