Easy Table Of Contents
FAQ

Troubleshooting

Common issues and solutions

Find solutions to common issues and learn how to fix the most frequent setup problems.

---

🚩 Most Common: TOC Not Appearing

If you have enabled the extension but the Table of Contents is not showing up, follow these steps in order:

1. Check App Embed Activation

Ensure the extension is actually active in your theme: 1. Go to Online Store > Themes > Customize. 2. Open App Embeds in the left sidebar. 3. Toggle Easy Table of Contents to ON. 4. Important: Click Save in the top right corner.

2. Verify Minimum Headings

By default, eToC only appears if your article has enough headings.
  • Check your Minimum Headings setting in the dashboard.
  • If your post has 2 headings but your setting is "3", the ToC will remain hidden.

3. Fix the Article Wrapper (CRITICAL)

Our discovery engine finds your content automatically in 95% of themes. If it fails, you must manually tell the app where your content is.

How to find your wrapper: 1. Open your blog post in a browser. 2. Right-click your article text and select Inspect. 3. Look for the HTML element that contains all your text (common classes: .rte, .article-template__content, .post-body). 4. Go to Advanced Settings in the eToC dashboard and enter that class in the Article Wrapper field.

Need help? Contact our support team—we will find your wrapper and configure it for you for free.

---

🎨 Styling & Layout Issues

TOC is hidden behind my Header

If your theme has a "sticky" header, it might cover the ToC or the headings when you click a link.
  • Fix: Adjust the Scroll Offset in the Smooth Scroll settings. Increasing this value will make the page stop further down, leaving room for your header.

Colors aren't matching my theme

eToC uses standard CSS, but sometimes themes have "Aggressive Styling" that overrides it.
  • Fix: You can add !important to your custom CSS in the dashboard, or contact us to provide a custom snippet for your specific theme.

Z-Index Issues (Overlapping)

If the ToC is appearing underneath your images or sidebar:
  • Fix: Go to Advanced Settings > Custom CSS and add:
    #easy-table-of-content-container { z-index: 999 !important; }

---

âš¡ Performance & Functionality

Links don't work (No scrolling)

This usually happens if another app is "hijacking" clicks on your page.
  • Fix: Ensure no other "Smooth Scroll" or "Back to Top" apps are conflicting. Our Vanilla JS engine is designed to avoid conflicts, but some legacy apps may still interfere.

Images are pushing headings out of place

If you use "Lazy Loading" for images, your headings might move after the ToC has already calculated their position.
  • Fix: Our engine has a 2-second Self-Healing loop that should fix this automatically. If it doesn't, ensure your images have height and width attributes in your HTML.
---

📩 Still need help?

We offer free setup and CSS customization for all users.

  • Email: support@bestdecoders.com
  • Response Time: We typically reply within 12–24 hours.
  • Include: Your store URL and the name of the theme you are using.
Back to Knowledge Base