Troubleshooting
Find the message you see, or the problem you have. If nothing here helps, report it.
Error messages
| Message | Cause and fix |
|---|---|
| Spacewright is not licensed on this site | The site has no active Spacewright licence or trial. A Confluence site admin can start the trial or buy a licence on the Atlassian Marketplace. Copies that were running stop with the status blocked; start them again once the licence is active. |
| Your Confluence admin has not given you access to Spacewright. | A site admin limited Spacewright to some groups, and you are not in them. Ask a site admin to add you to one of the groups in Confluence administration → Spacewright. |
| Only space admins (in the groups your site admin chose) can change template settings. | You need to be an admin of that space. If you are, a site admin may have limited template management to some groups. |
| Only Confluence site admins can do this. | The settings page and audit log are for Confluence site admins. |
| Space keys can contain only letters and numbers. | Remove spaces, dashes, underscores and accented letters from the key. |
| This key is already used by another space. | Choose another key. Space keys must be unique on the whole site. |
| The new space needs a different key. | The new key is the same as the source space's key. Choose another one. |
| "…" is required. | A required template value is empty and has no default. Fill it in. |
| This space is not set up as a template. | Someone turned the template off after you opened the screen. Reload the page and pick another template. |
| You cannot see the source space, or it does not exist. | You do not have permission to view the space, or it was deleted. Ask the space admin for access. |
| Space not found. | The space was deleted, or you cannot see it. |
| Only unfinished jobs can be resumed. | The job has already finished, failed, been cancelled or been blocked. Start a new copy if needed. |
| The space key … is already in use. Choose another key. | Someone created a space with that key between your start and the copy reaching that step. Start the copy again with a new key. |
| Something went wrong. Please try again; if it keeps happening, contact support with the time of the error. | An unexpected error. Try again in a minute. If it repeats, write to support with the time (and your time zone) and what you clicked. |
Common problems
I cannot find the space I want to copy
The list shows the spaces you can see, in alphabetical order, up to 250 at a time: press Show more spaces for the next ones. Or type part of the space's name or its key; if it is not found at once, press Search further until the list says all spaces were searched. Personal spaces and archived spaces are not listed. Check you have view permission on the space.
My template does not appear in the list
Check that Offer this space as a template is on and that the settings were saved, and that you can see the template space. Reload the Spacewright page.
The copy seems stuck
The progress bar is an estimate and can stand still while a large step runs, for example while big attachments copy. When Confluence asks apps to slow down, the copy pauses for a while by itself. If nothing has changed for 20 minutes, an hourly check restarts the copy, or you can press Resume if stuck in the job. Resuming does not create duplicate pages.
Pages in the new space are empty
Pages are created first and filled later in the copy. Wait until the job shows done. If a page is still empty afterwards, look for it in the report's Failed section: its content may be over 5 MB or Confluence may have refused the update.
A placeholder was not filled in
The report's Placeholders not filled section gives the reason. Either no value was given, or, in a page from the legacy editor, the placeholder is broken up by more than formatting (for example a line break) or its name is only partly formatted. Retype the placeholder in the template without formatting, and fill in the value by hand in the new space.
A link still opens the old space
Look the link up in the report under Links that could not be switched; the reason column explains why. Links to other spaces are left alone on purpose. Some link types are not handled yet: see the list.
An attachment is missing
Check that Attachments was ticked. Files over 250 MB are not copied and are listed under Failed. Only the latest version of each file is copied.
Pages are missing and are not in the report
Spacewright finds folders, whiteboards, databases and smart links at the top level of the source space, next to the home page, through Confluence search, and copies the pages inside them. If pages are still missing, open the report's Notes. When Confluence search refused the request, the first note begins Spacewright could not look for folders, whiteboards, databases and smart links at the top level of the space, and anything there is missing from the copy. Search can also lag behind: content created moments before the copy may not be found. Run a dry run again a minute later and compare the counts.
A copy includes only what the person who started it can see. Restricted pages are left out when Page restrictions is not ticked, and are then listed under Not copied. Copy anything still missing by hand. See content at the top level of a space.
I cancelled a copy and the new space is still there
Cancel stops the copy but does not delete what was already created. Delete the new space in Confluence if you do not need it.
The new space has the wrong permissions
If Space permissions was not ticked, Confluence gives the new space its usual defaults. Change them in the space settings. Page restrictions are copied by default. If Page restrictions was not ticked, restricted pages were not copied at all (they are listed under Not copied in the report); they were never copied without their restrictions.
A page called "Spacewright: restricted page being copied" is in the new space
Confluence refused to give that page its restrictions, so Spacewright left it empty instead of copying restricted content open. The report lists the page under Not copied with Confluence's answer. A common cause is a restriction that names a deactivated user. Delete the empty page, then copy the original by hand or fix its restrictions and copy the space again.
Other people cannot open the copy report
The report can name restricted pages, so only the person who ran the copy can see it. That person can share it by changing the page's restrictions.
Confluence will not let me create a space
Creating a space needs Confluence's own "create space" permission. Ask a site admin for it.