Using one Confluence Space by Artefact Version or one per Artefact


we plan to use Confluence for Software Documentation.

Is it better to use it like Atlassian Style: One Space per Artefact Version.

Or is it better to use a Space per Artefact and then add all Versions to this Space?

Creating a new Version by copying an old subtree...

Is there a good documenten way for beginner? Video? Tuturial? Book?



Next Step after Documentation an Requirements in Confluence is Setup of JIRA....

3 answers

1 accepted

1 vote
Accepted answer
David Simpson Community Champion Jul 10, 2011

The answer is likely "it depends". Whatever works best for you.

Having said that, Atlassian's usage, where they copy the space for the next version does seem to be a good example.

One space per version means that any search within a single space (if you're using the space specific search box in the Documentation theme) is guaranteed to be specific to that version (assuming the documentation is correct).

Also, if you have all versions in a single space, you can't have multiple pages with the same title. This may prove to be a problem.

Hi David,

thanks for this answer.

Is there a simple way to search over all spaces?


David Simpson Community Champion Jul 10, 2011

@Dirk Bromberg: Do you mean all spaces, or all spaces for your product's versions?

The former is easy (try the search in the breadcrumb/header bar).

The latter, is also achievable -- try this search for "Upgrade" in 2 Confluence spaces. You'd like need to make your own user macro to get a decent form displayed.

I'think we will start with one space per version. Thanks.

Suggest an answer

Log in or Sign up to answer
Community showcase
Posted Feb 06, 2019 in Confluence

Try out the new editing experience

Hi team, I’m Avinoam, a product manager on Confluence Cloud, and today I’m really excited to let the Community know that all customers can now try out the new editing experience and see some of the ...

1,360 views 97 8
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