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
Community showcase
Posted Feb 06, 2019 in Confluence

Try out the new editing experience

Hi team, I’m Avinoam, a product manager on Confluence Cloud, and today I’m really excited to let the Community know that all customers can now try out the new editing experience and see some of the ...

1,465 views 114 8
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