Space Copier for Confluence
Documentation · Version 2.1 · English and French
Demo video
Silent demo with captions, recorded with sample data.
Overview
Space Copier creates a new Confluence space from a template space, or copies any space you can see. Pages keep their sidebar order, with attachments, labels, page restrictions and blog posts. Variables such as {{Client}} written in the template are replaced with the values you enter. It uses the permissions of the person creating the space: no admin rights are needed beyond "Create space". The app runs on Atlassian.
Getting started
After install, open Apps > Space Copier in Confluence. Template spaces are set up from each space's Space settings.
Prepare a template (space admin)
- In the space you want to reuse, open Space settings, then Space Copier.
- Turn on "Template space". Only space admins can change this setting.
- Optional: write variables such as {{Client}} or {{Project manager}} in page titles, pages and blog posts.
Create a space from a template
- Open Apps > Space Copier. Every template space appears as a card with its name, key and description.
- Pick a template, or pick any space from the list of spaces you can copy.
- Enter the new space's name. A space key is proposed from the name; you can change it (letters and digits only). A key already in use is reported as you type.
- Fill in each variable found in the template. The first one is prefilled with the space name.
- Choose what to copy: home page and pages, attachments, labels, page restrictions, blog posts. All are ticked by default.
- Start the copy. Progress is shown step by step (space created, pages n of N, blog posts, variables). You can stop at any time.
- At the end, a summary lists anything that was not copied, with a link to open the new space.
Features
- Any space can be marked as a template by its space admins. Anyone who can create spaces can use it.
- Copy any non-personal space you can see, not only templates.
- Variables in {{double braces}} in page titles, pages and blog posts, replaced everywhere in the new space. Every variable must be filled in.
- Home page and all pages in sidebar order, with attachments, labels and page restrictions.
- Blog posts copied with their labels.
- The template space is never modified.
- Progress shown, Stop at any time, link to the new space.
- Light and dark themes, English and French.
Permissions and data
- The app runs on Atlassian's Forge platform (Runs on Atlassian). It uses no external servers.
- All calls run with the permissions of the user creating the space (asUser).
- read:space:confluence, read:confluence-space.summary: list spaces and templates, check that a space key is free.
- write:space:confluence, write:confluence-space: create the new space and mark or unmark a space as a template (stored as a space label).
- read:page:confluence, read:hierarchical-content:confluence, read:confluence-content.all, read:confluence-content.summary: read the template's pages, in order, with their content.
- write:page:confluence, write:confluence-content: copy the pages and replace variables in titles and content.
- read:blogpost:confluence, write:blogpost:confluence, read:label:confluence: copy blog posts and their labels.
- The app stores no personal data. No data leaves your Atlassian site.
Limits and what is not covered
- Not copied: page history, comments, whiteboards, databases, folders.
- Space permissions are not copied: the new space gets your site's default permissions.
- Personal spaces cannot be copied.
- You need the "Create space" permission. Without it, the app shows a message and nothing is created.
- If a copy is stopped or interrupted, the partial space is reported with a link to it.
FAQ
- Where is the app? Apps > Space Copier. Templates are turned on in a space's Space settings.
- Do I need to be a Confluence admin? No. You need the "Create space" permission. Marking a space as a template needs space admin rights on that space.
- No templates are shown. No space has been marked as a template yet. A space admin turns on "Template space" in Space settings. You can still copy any space you can see.
- Is the template changed when I create a space? No. Variables are replaced only in the new space.
- Why doesn't the new space have the same permissions? Space permissions are not copied. The new space gets your site's defaults.
Support
See the support page or email support@assetguard.fr with your site URL, the app name and a screenshot.