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.

Additional:

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

Heya,

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

com.atlassian.confluence.content.render.xhtml.migration

under your Confluence logging & profiling page.

Hope it helps.

Cheers,

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
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Posted Jul 10, 2018 in Confluence

We want to see the templates you've created in Confluence!

Hi Community, Jessica here from the Confluence Product Marketing team!  July’s community challenge is all about sharing pictures  — and as an extension of our first post on what ...

862 views 23 12
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