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

This widget could not be displayed.


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 yesterday in Confluence

Why start from scratch? Introducing four new templates for Confluence Cloud

Hi my Community friends!  For those who don't know me, I'm a product marketer on the Confluence Cloud team - nice to meet you! For those of you who do, you know that I've been all up in your Co...

155 views 2 4
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