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 |
Run options apply to verification as well as to the real migration, so a dry run reflects the settings you are about to use.
#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.
#Related
Values here. Reasons next door.
