RuffRuff TOC Help Center

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

Display on Blog Posts

Step-by-step instructions for adding the TOC to blog posts — available on all plans

Displaying the table of contents on blog posts is available on all plans.

OS 2.0 Themes (e.g., Dawn)

  1. Open the app home screen

  2. Select your theme under "Select a theme"

    If the selected theme is an OS 2.0 theme, "This theme is Online Store 2.0 theme." will be displayed directly below the selection box.

  3. Click the "Add app block" button next to "Blog post"

    The theme editor opens automatically on the blog post template

  1. Click "Add block (or Add section)" in the left sidebar and add "Table of Contents"

  2. Click Save

Legacy Themes (e.g., Debut等)

For legacy themes, the TOC is set up via the app embed.

  1. Open the app home screen

  2. Select your theme under "Select a theme"

    If the selected theme is an OS 2.0 theme, "This theme is Vintage theme." will be displayed directly below the selection box.

  3. Click the "Add app block" button next to "Blog post"

    The theme editor will open automatically with the app embed already enabled.

  1. Enable "Article (Vintage theme)" by toggling it on

  2. Click Save

FAQ

What is the difference between OS 2.0 themes and legacy themes?

There are two differences in how RuffRuff Table of Contents works depending on your theme type.

1. How the app is added to the theme

  • OS 2.0 themes: Add an app block

  • Legacy themes: Enable an app embed

2. Available display position options

OS 2.0 themes support all three options:

  • Specified in the theme editor

  • Before the first heading

  • Specify a CSS class name

Legacy themes support two options only:

  • Before the first heading

  • Specify a CSS class name

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.

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.