Skip to main content
Participating Frequently
December 12, 2025
Question

Incorrect TOC Highlighting in HTML5 Output

  • December 12, 2025
  • 4 replies
  • 220 views

Hi ,

I am using RoboHelp to author online help content and generating HTML5 output. I’m facing an issue with the left-side navigation panel (TOC highlighting) in the published help.

Problem Description
When I navigate to:

My Admin → Task Manager → Permit Alert

The correct content (Permit Alert) displays on the right pane.

But the TOC highlight on the left does not match the selected topic.

Instead of highlighting Permit Alert, it highlights Route Check.

This happens not only for this path but for all topics that have sub-sections under the same parent section.

Expected Behavior
The TOC should automatically highlight the exact topic that is clicked or opened, matching the content shown on the right.

Actual Behavior
TOC is highlighting a different sibling topic under the same group, even though the correct topic content loads.

Attempts Made / Observations
The topics and content files are correctly created.

All content loads properly; only the TOC highlighting is incorrect.

Issue occurs consistently across multiple sub-pages.

Request
Has anyone faced a similar issue with TOC auto-sync or highlighting in HTML5 output?
Any guidance on:

TOC-to-topic linking issues

Topic ID or Map ID conflicts

Sync TOC behavior

Steps to fix incorrect highlight mapping

would be greatly appreciated.

Happy to share additional details or screenshots if needed. Thank you!

    4 replies

    Jeff_Coatsworth
    Community Expert
    Community Expert
    December 12, 2025

    If you use another template, does it produce the same result? Do you see the same effect in the sample projects?

    Peter Grainge
    Community Expert
    Community Expert
    December 12, 2025

    Before sending, try one tthing.

     

    Create a new TOC in the project and recreate one section afresh. Does that section then work correctly?

    ________________________________________________________

    My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

     

    Use the menu (bottom right) to mark the Best Answer or Highlight particularly useful replies. Found the answer elsewhere? Share it here.
    sidwritesAuthor
    Participating Frequently
    December 12, 2025

    If it is in the second level, it works fine. When the third level sub section is added. It creates the issue.


    Best regards,

    -Sid
    [PII removed by moderator]

    Peter Grainge
    Community Expert
    Community Expert
    December 12, 2025

    Can you share the project? If you can, then see the Contact page on my site and send the project as instructed there. Do make sure you include a link to this thread and please do not email the project direct.

    ________________________________________________________

    My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

     

     

    Use the menu (bottom right) to mark the Best Answer or Highlight particularly useful replies. Found the answer elsewhere? Share it here.
    sidwritesAuthor
    Participating Frequently
    December 12, 2025

    Hello Peter!

    Due to NDA, I wont be able to share the company's project. Apologies.


    Best regards,

    -Sid

    Peter Grainge
    Community Expert
    Community Expert
    December 12, 2025

    The video doesn't help much as the text is so small that I, for one, cannot read it. However, the issue seems to be simple. If you click a TOC link the correct topic opens but the wrong topic is highlighted in the TOC. Correct?

     

    First, let's establish your version of RoboHelp. Please always start a thread with this information. Go to Help > About to get the full version number.

     

    Then you say "TOC is highlighting a different sibling topic".  What exactly do you mean by "sibling topic"? Simply another topic that has relevant content or is it created in some different way?

    ________________________________________________________

    My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

     

     

     

    Use the menu (bottom right) to mark the Best Answer or Highlight particularly useful replies. Found the answer elsewhere? Share it here.
    sidwritesAuthor
    Participating Frequently
    December 12, 2025

    Hello Peter!

     

    RH version is Version 2022.6.34. I referred  the incorrectly higlighting topic as sibling that is under the same head topic which is one level up. The other topic is a different one.