Prime Direction

Table of Contents

The Echo theme includes built-in support for automatic table of contents (TOC) generation for both posts and pages. The TOC is generated from the headings in your content and provides quick navigation to different sections.

Activation Methods#

There are two ways to enable the table of contents in your theme:

Method 1: Enable TOC for All Posts#

This method activates the table of contents for all your blog posts automatically (excluding pages). This is the recommended approach if you want consistent TOC across your entire blog.

Step-by-step instructions:

  1. Open your Ghost admin panel (see instructions above)
  2. Click on Settings in the left sidebar (gear icon)
  3. Scroll down and click on Design & branding
  4. Scroll down to find the Site-wide section
  5. Look for the Additional Features field
  6. Add the word toc to this field
    • If the field is empty, just type: toc
    • If you already have other features listed, add it with a comma: ..., toc
  7. Click Save in the top right corner

For more detailed information about configuring additional features, see the Additional Features documentation.

Result: After saving, all your blog posts will automatically display a table of contents at the top of the content, generated from the headings (H2, H3, etc.) in your posts.

Method 2: Enable TOC for Specific Post or Page#

This method gives you precise control, allowing you to enable the table of contents only on selected posts or pages. Use this if you want TOC to appear only on certain content.

Step-by-step instructions:

  1. Open your Ghost admin panel
  2. Click on Posts or Pages in the left sidebar
  3. Open the post or page where you want to add a table of contents (or create a new one)
  4. Click on the Settings button in the top right corner (gear icon)
  5. Scroll down to the Tags section
  6. Add a new tag by typing: #toc
    • Note: The # symbol is important - it makes this an internal tag (won't be visible on your site)
  7. Click outside the tag field or press Enter to confirm
  8. Click Update or Publish to save your changes

Result: The table of contents will appear only on this specific post or page.

How It Works#

The table of contents is automatically generated from the headings in your content:

  • It scans all headings (H2, H3, H4, etc.) in your post or page
  • Creates clickable links for easy navigation
  • Updates automatically when you add or modify headings

The TOC appears at the top of your content, allowing readers to quickly jump to any section they're interested in.