Frequently asked questions about RuffRuff Table of Contents.
In the current version, content created with theme sections cannot be included in the table of contents.
RuffRuff Table of Contents generates the TOC by parsing HTML heading tags (H1–H6) found in blog post body text (article.content), product descriptions (product.content), page content (page.content), and collection descriptions (collection.description).
Content added via Shopify sections (page builder blocks) exists in a separate part of the DOM and is not currently supported as a TOC source.
Heading elements added as theme sections or blocks cannot automatically be included in the table of contents.
The TOC only covers headings within content created in the rich text editor (content body). Structure your content using heading formats within the product or post description to have them reflected in the TOC.
There is no built-in transparency option, but you can achieve a similar effect by setting the TOC background color to match your theme's background color.
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
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.
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.
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.
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.
There is no built-in transparency option, but you can achieve a similar effect by setting the TOC background color to match your theme's background color.
The TOC automatically uses the font set by your theme.
RuffRuff Table of Contents does not apply its own font family and inherits the theme's CSS. You can adjust the font size (in px) from the app's Settings page.
To change the font family itself, you may be able to add styles to the .ruffruff-table-of-contents selector in your theme's custom CSS (requires knowledge of theme customization).
Phone and video call support (e.g., Zoom) is not currently available.
Support is provided via a dedicated contact form in both English and Japanese.