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

This widget could not be displayed.
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.

This widget could not be displayed.

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.

This widget could not be displayed.

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

Suggest an answer

Log in or Sign up to answer
Atlassian Summit 2018

Meet the community IRL

Atlassian Summit is an excellent opportunity for in-person support, training, and networking.

Learn more
Community showcase
Published Tuesday in Confluence

Add-on evaluation with confluence templates

Atlassian market place contains number of Apps/Addons which improves the capability of out of the box Atlassian products. It is good to follow a plugin evaluation process before install add-ons. So t...

170 views 12 7
Read article

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