confluence: After 3.1 to 4.2.1 upgrade: TOC macro does not operate properly

We just upgraded from 3.1 to 3.5 to 4.2.1

This affects all my pages with TOC macro. The pages are long, with 25-50 TOC entries.

Issue: TOC appears visually, but either none of the entries are clickable, or only the first 2-4 entries are clickable.

This affects the TOC in view mode in browser and when the page is exported to pdf, the pdf TOC has the exact same behavior.

I tried removing the toc macro and re-inserting it via Insert | Macro.


It appears the areas of TOC that are not clickable are in a huge "wiki markup" section of this document. Appears this section did not migrate to new format, but works fine as wiki markup, and looks good.

Halp and thank you!!

1 answer

1 accepted


Try the following steps to force migration of your content

  1. Re-run migration
  2. Ensure that all plugins is compatible and updated to the latest release version
  3. Re-attempt migration
  4. Double check if the wiki-markup content has been migrated

If the above steps still failed, we highly recommend you to create a support ticket so that we could analyze it deeper on where is the failed migratin occurred.

If you would like to investigate it, you could try the above steps again with the following class configured at DEBUG


under your Confluence logging & profiling page.

Hope it helps.


Septa Cahyadiputra

This really helped! I fixed the big problem page in front of me....

However, when I re attempt, it tells me 9 pages did not migrate, but it does not tell me the names of the pages! I can fix them by hand.... if I know which ones they are...

Suggest an answer

Log in or Sign up to answer
Atlassian Community Anniversary

Happy Anniversary, Atlassian Community!

This community is celebrating its one-year anniversary and Atlassian co-founder Mike Cannon-Brookes has all the feels.

Read more
Community showcase
Kesha Thillainayagam
Posted Apr 13, 2018 in Confluence

We want to hear how your non-technical teams are using Confluence!

Hi Community! Kesha (kay-sha) from the Confluence marketing team here! Can you share stories with us on how your non-technical (think Marketing, Sales, HR, legal, etc.) teams are using Confluen...

2,691 views 25 10
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you