Step 1: Introduction and acknowledgements

Nothing about this step is decorative. Each of the four boxes corresponds to a real property of how the migration works, and the Continue button stays disabled until all four are ticked.

There is an Accept all button. Read them once before you use it.


#What you are agreeing to

Acknowledgement

Why it is there

You have a backup, or you are running in a sandbox

Migration rewrites page content. Page history makes it recoverable, but a backup makes it recoverable quickly.

Any page can be undone from Confluence page history

Every changed page gets a new version, so the previous version with the original macro is still there.

This modifies page content and creates a new version on every page it touches

Watchers may be notified, and page version numbers will move. On a large space that is a lot of versions.

Navigating away, or losing network or power, stops the run

The whole run happens in this browser tab. There is nothing running in the background to come back to.


#A few things that catch people out

  • The hint under the button reads "Accept all 4 to continue". If Continue is greyed out, that is why.

  • This step is a good moment to decide whether you are running against production or a sandbox. It is the last cheap moment to change your mind.

  • Booking a walkthrough is free and is the fastest way to de-risk a large migration.



Read them once. Then Accept all.