Find answers to common questions about setup, table of contents generation, position, design, and pricing for RuffRuff Table of Contents. Where detailed steps are needed, we link to the relevant help article.
Any of the following may be the cause.
Headings: The body has no headings that are included in the table of contents.
App status: The app is disabled on the home screen.
Theme: The theme has no app block or app embed.
Hide setting: The
table_of_contents.hiddenmetafield is set to 1.
For the checks, see Table of Contents Not Displaying.
You can add the "Table of Contents" app block to Online Store 2.0 blog post templates. App blocks for products, pages, and collections are available only on Regular Plan. Templates such as blog lists and the home page are not supported for displaying a table of contents. On vintage themes, use an app embed.
For details, see App Block or App Embed Not Appearing.
A warning may appear in the "Blog posts" row on the home screen. You can still use the link to open the theme editor even if there are no published blog posts.
If you cannot open a template for products, pages, or collections, see Cannot Access a Template.
Any of the following may be the cause.
You have not saved your changes in "Customize the table of contents" or the theme editor.
You are viewing a different theme from the one where you added the app block.
You are using settings that require Light Plan or higher while on Free Plan.
Per-block settings override the title and button text in the shared settings.
Your browser still has cached content.
For the checks, see Settings Not Being Applied.
On Online Store 2.0, add an app block. On vintage themes, enable an app embed. The "Specify in Theme editor (Online Store 2.0 Only)" position option is available only with app blocks.
For details, see App Block vs. App Embed.
App blocks and app embeds are configured separately for each theme. If you switch themes, check the settings on the theme you switched to. Reinstalling the app turns the app embed off again. Add the "Table of Contents" app block back to the target template. On vintage themes, enable the appropriate app embed and save.
For the steps, see Initial Setup.
If a page has two or more tables of contents, for example because both an app block and an app embed are enabled, only the one closest to the top of the page remains. The others are removed. On Online Store 2.0 themes, disable the app embed and add only an app block to the target template.
For details, see App Block vs. App Embed.
No. The table of contents includes only H1–H6 headings in Shopify's standard blog post body, product description, page body, or collection description. Headings added through theme sections, page builders such as PageFly or GemPages, or metafields are not included. Content created with these tools is included only if it is saved in the standard body field.
No. There is no feature for excluding headings individually. Change any heading you want to exclude to a level that is not selected in "Headings." This also changes its visual size.
For the Headings setting, see Customize the Table of Contents.
Yes. To hide it on individual content, use the table_of_contents.hidden metafield. A value of 1 hides the table of contents on the blog post, product, page, or collection. Define the metafield in Shopify admin → Settings → Metafields and metaobjects. On Online Store 2.0, you can also use separate templates for content with and without a table of contents.
For the steps, see Hide the Table of Contents on Specific Content.
No. Switching by category is not supported. Use the hide metafield or assign different templates to individual posts.
No. The table of contents is displayed even if there is only one heading at a selected level. Use the hide metafield if you do not want it to appear.
The font family follows your theme settings. The app does not specify a font family. You can change the size (px) in "Customize the table of contents."
No. Transparent backgrounds are not supported. Setting the background to the same color as the theme where the table of contents is inserted can approximate transparency.
On Light Plan or higher, setting "Initial Display Lines" to 0 initially hides all items. Customers can open it with "show all." If you have not changed the button text, it remains the English text show all. The show/hide button is a separate setting. If you have not changed its text, it displays hide when the table of contents is open and show when it is closed.
For the settings, see Customize the Table of Contents.
If Position is set to "Above the first heading" or "Specify class name," the table of contents moves after it is rendered. This movement does not occur if Position is set to "Specify in Theme editor (Online Store 2.0 Only)."
No. The app does not support a sticky table of contents that follows the screen, or highlighting items based on the scroll position.
No. The app does not support images inside the table of contents, related posts or product cards, or integration with rich snippets.
Table of contents headings are generated from the body at display time, so they appear in the translated language if a translated body is available. Shared text entered in the app's "Customize the table of contents" screen is not translated. On Light Plan or higher, text configured individually for each block can use the theme's translation features.
For the steps, see Translate Block Text.
No. The app uses app blocks or app embeds, so it does not add files to the theme or modify existing code.
Yes. Branding is hidden automatically on Light Plan or Regular Plan. No configuration is needed. Even on Free Plan, branding does not appear in the theme editor preview, when the store's email address ends in @shopify.com, or when the store's domain contains myshopify.com.
No. Each store needs its own plan subscription. If you use the app on another store, subscribe to a plan on that store as well.
Settings data is not deleted. If you change from Regular Plan to Light Plan or Free Plan, tables of contents stop appearing on products, pages, and collections. If you change to Free Plan, features that require Light Plan or higher, such as the show/hide button, Custom Liquid, and per-block text, are also no longer applied.
Support is available only through the contact form. We do not offer support by phone or online meeting. Contact us through the contact form.
The app does not access customer data and has no permissions for customer data. It uses only headings in the bodies of blog posts, products, pages, and collections (the description for collections), together with the app's display settings, to create the table of contents. It does not retrieve names, phone numbers, email addresses, addresses, customer tags, customer metafields, login status, or order history.
If the checks above do not resolve the issue, contact us through the contact form.
Include the following information when contacting us.
The target store's myshopify.com domain
What you want to confirm
The target page URL (for display issues)
The checks you have already completed