How to copy Confluence pages to another space with their child pages
By Jake Marsh · Updated
To copy a Confluence page and its child pages to another space, open the top page, click ••• (More actions) and choose Copy page tree (on some sites it's under Apps). Pick the destination Space and, under Put the copy under, a parent page there, or leave it empty for the top level. Click Preview copy, check the counts and any title clashes, then Start copy. Clean Copy copies every page in source order with its attachments, labels, properties and restrictions, then points links between the copied pages at the copies.
Why links break when you copy across spaces
Confluence stores many links as a page title without a space. Copy a page into another space and those links look for that title in the new space, where it may not exist or may be a different page. This is a known Confluence issue, CONFCLOUD-37772. Includes, excerpt includes and page tree macros have the same problem.
Clean Copy fixes this in a second pass after the pages are copied: links to pages inside the copy point at the copies, and links to pages you didn't copy are pinned to the original space so they keep working.
Steps
- Open the top page of the tree you want to copy.
- Click ••• > Copy page tree.
- Choose whether to include the page itself. It's on by default; turn it off to copy only the pages under it.
- Pick the Space to copy into. You need permission to add pages there.
- Search for a parent under Put the copy under, or leave it empty.
- Set titles if you need to. Add text before or after every title, or up to six find and replace pairs, applied in order.
- Check what comes along: attachments, labels, page properties, page restrictions and link fixing are all on by default.
- Choose what happens on a title clash: rename the copy (adds " (copy)"), skip that page and its children, or stop the whole copy.
- Click Preview copy, read it, and click Start copy.
- Follow it in Apps > Clean Copy, or close the window; it keeps going.
What the preview tells you
| In the preview | What it means |
|---|---|
| Items by type with What happens | Pages, folders and blog posts are Copied; anything else is Listed in report only |
| Deepest level | How many levels the tree goes down |
| Titles that already exist in the destination | The first 15 clashes, then a count |
| Warnings | Restrictions turned off, items Confluence can't copy, an empty tree |
The preview runs as you, so a copy only ever contains pages you can see.
Copy or move?
Moving a page tree changes where the original lives; copying leaves the original alone and makes a second set of pages. Copy when both spaces need the content, such as a template section reused for each team, or when the original should stay as a record. Move when the content belongs in one place only.
What doesn't come along
- Comments and page history; each copy holds the current version.
- Whiteboards, databases and smart link embeds, which Confluence can't copy. They're listed in the report, and the pages under them are copied under the nearest copied parent.
Clean Copy starts with Atlassian's 30-day free trial; prices are on the Clean Copy page.
What it costs
Clean Copy is From $9 a month for up to 10 users. Every plan and the install link are on the Clean Copy page.
Clean Copy: Copy Spaces and Page Trees for Confluence
Copy a Confluence page tree or a whole space with attachments, restrictions and working links. Previews first, resumes on failure. From $9 a month for up to 10 users.
Questions
Is there a limit on how many child pages can be copied?
No page limit. The tree is read in full at every level, and pages are created in the same order as the source.
Can I copy a page tree under a page inside itself?
No. A tree can't be copied under itself or under any page inside it.
Who shows as the creator of the copied pages?
Clean Copy, because background copies run as the app. The copy's report records who started it.
Can I copy to a space I can only read?
No. You need permission to add pages in the destination space, and the app needs it too; the preview warns you if Clean Copy lacks it.