Narrowing what gets migrated
Scope is decided by a search filter, and by which of the two entry points you opened. There is no page picker and no page-count cap, which means a site-wide run is one click away and worth being deliberate about.
The filter applies to every count you see and to the run itself, so the numbers on the Select apps step are always the true blast radius.
#At a glance
Option | Values | Default |
|---|---|---|
Narrow the pages (search filter) | Any Confluence search clause | Empty, the whole site, or the pinned space on the space-level page |
#The two entry points
Entry point | Scope | Who can open it |
|---|---|---|
Confluence Settings, under Capable | The whole site, unless you add a filter | Confluence administrators |
Space settings, under Capable | Permanently narrowed to that one space | Space administrators |
On the space-level page, the space filter is always applied on top of whatever else you type. You cannot widen it back out from there.
#Writing a filter
The filter box takes any Confluence search clause, and offers one-click examples for the three common cases.
You want | Filter |
|---|---|
One space |
|
Recently edited pages |
|
Pages carrying a label |
|
One space, recently edited |
|
Typing is debounced before the counts refresh. If Confluence rejects the filter, every count falls back to zero and the page tells you the filter was rejected. Zero counts across every app usually means a bad filter rather than a clean site.
#A pilot scope worth copying
Pick one space with real content in it, filter to that space, and run the whole thing end to end including the review. It costs an hour and tells you more than any amount of planning.
#A few things that catch people out
There is no page picker. If you need to migrate a specific list of pages, the only lever is a search filter that happens to select them.
There is no page-count cap and no confirmation dialog before a site-wide run. The four acknowledgements on step 1 are the only guard.
Pages are processed oldest-first by page id, so a run stopped half way through has covered your oldest content, not your most important.
#Related
One space first. Always.
