RuffRuff TOC Help Center

How to Display the Table of Contents
Customizing the Table of Contents
Troubleshooting
Plans

About This App

An introduction to the features and highlights of RuffRuff Table of Contents for your Shopify store

An introduction to the features and highlights of RuffRuff Table of Contents for your Shopify store

What is RuffRuff Table of Contents?

RuffRuff Table of Contents is an app that automatically adds a table of contents to your Shopify store's blog posts, products, pages, and collections. It detects headings (H1–H6) in your content and displays a clickable TOC that lets visitors jump to any section.

Key Features

  • Display a table of contents on blog posts (free)

  • Display a table of contents on products, pages, and collections (Regular Plan only)

  • Rich design customization: title, font size, spacing, colors, and more

  • Flexible display position: before the first heading, via the theme editor, or by CSS class

  • Smooth scroll support (free)

  • Show/hide toggle button (Light Plan and above)

  • Limit initial display lines with a "Show all" button (Light Plan and above)

  • Hide the TOC on specific content (free)

  • Display custom banners, ads, or other content above or below the TOC (Light Plan and above)

What This App Cannot Do

  • Generate a TOC from headings outside the content body (e.g., section headings added via the theme editor)

  • Generate a TOC on pages other than blog posts, products, collections, and pages

Supported Themes

Both OS 2.0 themes (e.g., Dawn) and legacy themes are supported. OS 2.0 themes use the app block format; legacy themes use the app embed (App Embed) format.

FAQ

Cannot access a template

If you see a "Cannot access" message when trying to open a template in the theme editor, it means no published content of that type currently exists in your store.

I added the app but the TOC is not showing

There are three possible causes:

  • No headings exist in the content for the TOC to useInsert headings into your content using the heading levels configured in RuffRuff Table of Contents, then check again.

  • RuffRuff Table of Contents is set to "Disabled"Open the app settings screen and set the status to enabled.

  • The TOC block in the theme editor is set to "Hidden"In the theme editor, check that the eye icon next to the TOC app block is not grayed out.

If the issue persists, please contact us.

The TOC app block is not appearing in the theme editor

  • Your theme is not an OS 2.0 themeApp blocks are only supported on OS 2.0 themes. If you are using a legacy theme, please enable the app embed instead.

  • You have a non-supported template openThis app only supports the blog post, product, page, and collection templates. Please navigate to one of these templates.

  • You are not on the Regular PlanThe product and page templates are only available on the Regular Plan. Please upgrade to the Regular Plan to add the app to these templates.

Settings changes are not reflected in the TOC

Shopify's cache may delay the update from appearing. Please wait a while and check again.

If the issue persists after several tens of minutes, please contact us. Please note that we may request collaborator access to your Shopify store in order to investigate.