# 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

[Migration optionsWhat each one is for.](https://help.gocapable.com/migration/migration-options.html)

[Migration behaviour versionsThe version picker.](https://help.gocapable.com/migration/migration-behaviour-versions.html)

[Limits and capsThe numbers.](https://help.gocapable.com/migration/limits-and-caps.html)

---

_Values here. Reasons next door._