Copy Page Tree Server and Data Center - User Guide

The following is for Copy Page Tree Server.  Copy Page Tree Cloud information may be found here.

The Copy Page Tree app allows you to add a page action to copy not only the current page but a complete page hierarchy. The app supports adjustments of page names to avoid problems with page name duplication. Copies can be saved to other Spaces as well.

Click to View in Marketplace



  • Copy an entire page tree, Parent Page and its Child Pages, including page Attachments
  • Rename pages to be copied
  • Review the page tree copy
  • Supports page name adjustments to avoid issues with page name duplication
  • Delete an entire page tree (might need to be enabled)
  • The progress bar gives real-time feedback about the progress of the copy job
  • Quick links to Source and Destination pages upon copy completion

No macro found named "CPT use case" on page "Copy Page Tree Cloud - User Guide" in space "SUP".

If you're experiencing issues please see our Troubleshooting Guide.

User Guide 

The following screenshots are from the Cloud version.  The Server version operates essentially the same. 

How to copy a page tree 

  1. Start on the page you want to copy along with all its child pages.

  2. In the Tools menu drop-down, select Copy Page Tree

  3. The Copy Page Tree macro displays
  4. Select the page tree destination
    1. Under Select Destination section, select the page you want to copy the tree (the page you started on in steps 1 & 2 above) to
    2. (warning) Space and Parent Page must already exist in order for it to show in the destination dropdowns
    3. Example:
      1. To copy the Parent Page titled Page tree you want to copy in the Sandbox Space, and all of its child pages, to the page, titled Destination page - where you want the copied page tree you would:
        1. Select Sandbox in the Space dropdown
        2. Select Destination page - where you want the copied page tree in the Parent Page dropdown
    4. (info) You can choose a destination in a different Space than the location of the page tree you are copying
  5. Customize your output if needed
    1. Copy is already prefilled for you however you may edit how you wish.
    2. Clicking Expand All allows you to view all the pages in the tree.
  6. Click Copy
    1. The copying process begins followed by a confirmation page
  7. Click Go To New Page
    1. Your copied Parent Page and all of its Child Pages have been copied to your chosen destination page, viewable in the sidebar under Pages.

    2. (warning) You must insert the Page Tree Macro to view the copied page tree on your destination page. See the below instructions for adding the page tree macro.

Customize the Output on your new pages

Page Content

  1. allows you to replace certain words or phrases inside the content of your pages
    1. enter the phrase you wish to replace in the "replace" field.
    2. enter the new phrase in the "with" field
  2. This will not replace phrases/words that are in your page titles

Page Titles

  1. Change the Page Titles
    1. Prefix: add a new word or phrase to the beginning of your Title
    2. Suffix: end a new word or phrase to the end of your Title
      1. (copy) is the default suffix to help make sure you have a unique title
    3. Replace: Change words or phrases in your titles
      1. This will not replace phrases/words that are in your page content

Permissions for Copy Page Tree Tool

A user must have edit permissions for a page in order to have the "Copy Page Tree" tool available in the page menu.

For each page in the tree that is being copied the user must have view permission for the page.  If they do not then that page will be skipped in the copy.

For the destination page, the page that will become the root page of the copied tree, the user must have view permission.

For the destination space the user must have:

  • the add permission for pages
  • the add permission for attachments (if copying attachments)
  • the add permission for comments (if copying comments)

Permissions for Delete Page Tree Tool

Note that, by default, space permissions are set so that confluence-users do NOT have the Page --> Delete permission. The first step that an admin must take to allow regular (non-admin) confluence-users to use "Delete Page Tree" is to grant Page --> Delete to confluence-users.

If a user has "remove" permissions on the parent page but not on some child pages the "Delete Page Tree" tool is available.  When it is used to delete the page tree, restricted pages in the tree will not be deleted.  Restricted pages will remain while the other pages are deleted.

How to add Page Tree macro after copying a page tree 

  1. On your destination page click the page Edit button (pencil icon) then Other Macros
  2. Search for and select Page Tree macro

  3. Select the Root Page

  4. Select the Start Depth, the level of child pages you want to display and click Save

  5. Your newly copied page tree now displays on your destination page

Release Notes

Knowledge Base & Support Info