Options reference

The complete list, including the ones on the results and repair screens that are easy to miss.

For the four that change the outcome of a run, the Migration options page explains the trade-offs rather than just the values.


#Run options

Option

Values

Default

Migration behaviour (version picker)

v1.0.0 Standard migration (marked Recommended) / v1.1.0 Diagram version history / v1.2.0 Capable standalone app content

v1.0.0

Skip errors

On / Off

On

Keep source macros

On / Off

Off

Classic draw.io layout (beta), under Advanced options

On (classic) / Off (Capable Auto)

Off

Use Admin Key (experimental), under Advanced options

On / Off

Off

Narrow the pages (search filter)

Any Confluence search clause

Empty, the whole site, or the pinned space on the space-level page

App selection

Any number of detected apps

None

Macro selection

Any number of macros with a count above zero

None


#Results and repair options

Option

Values

Default

Hide pages with no changes (results)

On / Off

On

Pause list (results, while running)

Paused / Live

Live

Rows per page (results)

25 / 50 / 100 / 200

50

Include pages edited after migration (rollback)

On / Off

Off

Stop on first error (repair and rollback)

On / Off

Off

Layout to apply (Repair diagram layout)

Classic (draw.io layout) / Auto (scale to the page)

Classic

Log scope (Repair diagram tabs)

Detected issues (recommended) / All draw.io embeds

Not set, you pick a card

Page source (Repair diagram tabs and Repair diagram layout)

Migration log / Page IDs

Not set, you pick


#A few things that catch people out

  • Run options are chosen two steps before the run buttons, and the wizard never returns you to them.

  • Nothing here is remembered between sessions.

  • The behaviour version is the one most often left wrong, because the default is the fastest option rather than the most complete.



Values here. Reasons next door.