The copy report
When a copy or a space created from a template finishes, Spacewright writes a report page into the new space. It answers the question "why didn't X come across?" without anyone having to compare the two spaces by hand.
Where to find it
- It sits directly under the new space's home page, titled Spacewright copy report YYYY-MM-DD (xxxxxxxx).
- The eight characters in brackets are the start of the job ID. Please quote them when you contact support.
- The finished job in the Jobs tab has a link: Open the copy report.
- Only the person who ran the copy can see it. The report can name restricted pages, so Spacewright restricts it (view and edit) to that person before writing it. To show it to others, change its restrictions like any page's.
- If Confluence does not let Spacewright restrict the report, the report is written for everyone who can see the new space: restricted pages are then counted, never named, and the report says so at the top.
- Otherwise it is a normal page: you can move, edit or delete it.
- Cancelled copies, and copies stopped by an error, have no report.
What it contains
| Section | What it shows |
|---|---|
| Header | Source space, new space, type of copy, start and finish time (UTC) and the result: completed, or completed with problems if a step failed, an attachment failed, or a page, folder or blog post that should have been copied was not created. Items under Not copied or Skipped do not change the result. |
| Totals | Pages, folders, blog posts and attachments copied; links switched; links that could not be switched; restricted pages copied with their restrictions; items not copied (restricted content, whiteboards, databases, smart links); items skipped (archived, drafts, options); items that failed, attachments included. |
| Links switched, by type | How many links of each type were switched to the new space, for example page links, blog post links, web links, smart links, macros (such as Include page or Children), CQL queries and images or files. Shown only when links were switched. |
| Not copied | Restricted content that was left out (see restricted pages), and whiteboards, databases and smart links (embeds) that Spacewright found in the source space but cannot copy, including those at the top level of the space. Each row gives the item's title, its type, where it is in the source space (Top level of the space, or Under "…" with its parent's title) and why. They stay in the source space; add them to the new space by hand if you need them. If none were found, the section says so. |
| Skipped | Items left out because of their status or an option you chose, each with the reason. |
| Failed | Items that could not be copied, with the error message. Pages and other steps are tried three times before they are listed here. Attachments that are too large or whose upload fails are listed here too: the file name, the page it is on, and the reason. |
| Links that could not be switched | The page, the link and the reason. These links still point where they pointed before. |
| Placeholders not filled | Only for spaces created from a template: placeholders that had no value or were split by formatting. |
| Notes | Title clashes, pages placed under a different parent because the item they sat under was not copied or was skipped, and variables without a value. If Confluence search refused the request for top-level content, the first note says so: anything at the top level of the space, and everything inside it, is then missing from the copy. |
Each table shows at most 500 rows. If there are more, the report says how many were left out.
Links that point to other spaces or other sites are left as they are on purpose. They are not listed.
Why items are not copied or skipped
| Item | Section | Why |
|---|---|---|
| Whiteboards | Not copied | Confluence has no API to read or write whiteboard content. |
| Databases | Not copied | Confluence has no API for apps to write database entries. |
| Smart links in the page tree (embeds) | Not copied | Not copied yet. Use the title and the place in the source space shown in the report to find each one, and add it again in the new space. |
| Restricted pages, when Page restrictions is not ticked | Not copied | Spacewright never copies a restricted page without its restrictions. Everything inside a page with view restrictions is left out too. |
| Restricted pages whose restrictions Confluence refused, or could not be read | Not copied | The page is not filled in, and neither is anything inside it. If Confluence refused the restriction, an empty page titled Spacewright: restricted page being copied (…) is left in the new space, visible only to you where Confluence allows; delete it. |
| Restricted folders | Not copied | Spacewright cannot copy folder restrictions, so a restricted folder and everything inside it are left out. |
| Archived pages | Skipped | Skipped unless you tick Archived pages. |
| Drafts | Skipped | Unpublished drafts are never copied. |
| Blog posts | Skipped | Skipped when Blog posts is not ticked. |
Restricted pages. With Page restrictions ticked (the default), each restricted page and blog post gets its view and edit restrictions as soon as it is created, before its content, attachments or child pages, and you are added to them. The Totals row Restricted pages copied with their restrictions counts them. Restricted content is never copied open.
Pages that sat inside an item that was not copied or was skipped (for example inside a whiteboard) are still copied, unless that item had view restrictions: then they are not copied either, because in the new space they would lose that protection. They go under the nearest parent that was copied, in that item's place among its siblings. Under a whiteboard, database or smart link at the top level of the space, whose place Spacewright cannot read, they go to the top level of the new space after the other top-level items. The Notes section names each page or folder that moved.
Links that could not be switched
The most common reasons, as they appear in the report:
| Reason in the report | What it means and what to do |
|---|---|
| page was not copied; link still points to the source space | The link goes to a page that was skipped or failed. Copy that page by hand, or change the link. |
| page not found in the source space (broken before the copy) | The link was already broken in the source space, for example to a deleted page. |
| linked page title not found in the source space | The link uses a page title that no longer exists, often because the page was renamed after the link was made. Fix the link in the new space. |
| parameter equals the source space key but this macro is not known; left unchanged | A macro from another app holds the source space key. Spacewright does not know that macro, so it does not touch it. Check the macro's settings. |
| version comparison links cannot be copied | The link compares old page versions. Page history is not copied. |
| link to an older version or the history of a page; page history is not copied, so the link still points to the source space | The link opens an old version or the history of a page. It still works, but shows the source page's history. Change it if it should open the copy. |
| attachment file was not copied | The page shows a file that was not copied, because Attachments was not ticked or the upload failed (see Failed). |
| template is not a space template of the source space | A "Create from template" button uses a site-wide template or one from another space. It is left as it was. |
What Spacewright keeps
The report page stays in your Confluence until you delete it. The working data Spacewright used to write it (page titles, IDs and link notes) and the job record are deleted 30 days after the job ends. See the privacy policy.