Best practice for handling multiple versions of a space (software documentation)


I have to maintain the documentation for a piece of sofware and on each page I've added a related content macro, and added labels to pages.

Now, a new version of the software is out, and I've duplicated the old space to start updating the docs for this new version. Both the new and old doc spaces need to co-exist, since not all customers will upgrade to the new version and we can't just drop support for the old version.


Now the related content macro of course shows pages both from the old and new space. So it seems I have two choices:

1. Edit the labels in each and every page, and add a suffix, such as mylabel_v2

2. Edit the related content macro on each and every page, to only include the new space

In both situations I'm looking at a very painful and boring procedure of doing the same change to 200+ pages.

Is there a more elegant solution? Is there a way to bulk edit a common element on a page? Is there a macro I should have used to wrap the related macro with, that would have allowed this? Is there a way to bulk edit labels, which allows adding prefix/suffix to a bunch of labels?

Thanks for any suggestions!

2 answers

1 accepted

This widget could not be displayed.

Hi Mihai,

I am not 100% on how to accomplish all the changes but utilizing the CLI tool would be a good start.

Confluence Command Line Interface

It can be used to automate mass changes in Confluence. Maybe it can help with the changes we are trying to make here so I would adcvise investigating.


This widget could not be displayed.

Thank you Andrew, I will take a look at that :)

Suggest an answer

Log in or Sign up to answer
Community showcase
Posted Monday in Confluence

Why start from scratch? Introducing four new templates for Confluence Cloud

Hi my Community friends!  For those who don't know me, I'm a product marketer on the Confluence Cloud team - nice to meet you! For those of you who do, you know that I've been all up in your Co...

471 views 6 6
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you