---
title: "Adding a Table of Contents"
description: "Add a Table of Contents to help readers navigate long articles effortlessly. Enable in Meta settings, but ensure proper HTML markup to avoid display issues."
url: "https://support.helpdocs.io/article/pxWAp5tLwU-adding-a-table-of-contents"
category: "Managing Content"
updated_at: "2026-08-03T15:48:20Z"
---
# Adding a Table of Contents
If you're writing guides or long-form articles you might want to add a **Table of Contents** (TOC). This makes it way easier for people to navigate your article, especially when you have 4 or more sections.
[Embedded iframe](https://player.vimeo.com/video/1214963134)
1. Head to the article you want to add a Table of Contents to
2. In the top bar click  **Meta** > **Edit slug, tags, etc.**
3. Scroll down and tick **Table of Contents**
4. Click **Apply changes & close**
5. Hit **Save Changes**
Your visitors will now be able to navigate your long articles effortlessly 💫
**If your TOC isn't displaying correctly (or at all) check your HTML markup.**
We do a pretty good job at stripping away bad HTML before we create the table of contents, but sometimes if you've pasted an article from another service the TOC won't display, or it'll display wrong. To fix this, [switch to HTML mode](https://support.helpdocs.io/article/Pu2Lkzf2Nu-switching-the-editor-mode) and make sure all the headings are just headings like this `Heading Text
` no bold, italic, spans, etc. and make sure there are no blank headings like this ``