It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

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
Answer accepted

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?


@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
Published in Confluence

6 Awesome Ways to Apply Trello, JIRA and Confluence to your Project

I attended  Atlassian Summit 2019  and learned a lot from the presenters, attendees and knowledgeable Atlassian product managers. The presentations I attended focused on applying Agile, pla...

3,764 views 15 37
Read article

Community Events

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

Find an event

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

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you