How do I include a specific version of a page?

This question is in reference to Atlassian Documentation: Include Page Macro

Oftentimes, I need to include a specific (released) version of one page in another page. How can this be done?

1 answer

This widget could not be displayed.
Timothy Chin Community Champion Jan 27, 2017

Don't think the Include Page Macro does that but you can place a link to the version of the page:


We want to be able to print a collection of specific versions of pages as PDF. For that, I need to include them, not just link them, right?

Correct, but the include macro will always take the current version of a page, that's what it's for.

Is there another macro then that is for including a specific version of another page?


It's because a page in a wiki is in theory a live working document, so readers will generally always want to see the current version.

When doing documentation though, that can be wrong.  Atlassian themselves use "Scroll Viewport" on their own Confluence to support documentation properly.

No, I'm afraid not.

Conflluence is a wiki, with an implicit assumption that the users will want to see the current version of a page.

This doesn't work too well for documentation though, and it's a bit of a weakness IMHO.  Even Atlassian admit it implicitly - their docs on the products are, of course, held in Confluence.  With Scroll Viewport in use to enable Conflluence to do the required "fetch version of pages related to specific versions of products".

Scroll Viewport looks like an interesting solution that could solve our problems. Is something similar available also for Cloud hosting?

@Nic Brough [Adaptavist] You mention Scroll Viewport to manage page versions for publications. There is also a plug-in App Scroll Versions which indicates to do this as well. Although the license price is much higher then for Scroll Viewport. Do we need to use the Scroll Version in combination with Scroll Viewport to publish specific page versions as a package or is this functionality also include in Scroll Viewport? We are looking into a solution to publish a certain package version of a space.

Hi @Henk Aarts, versions functionality is not included with Scroll Viewport, for this you would need Scroll Verisons.

Atlassian is using both Scroll Versions and Scroll Viewport to create, manage and publish their documentation. The version picker you see in Confluence documentation is achieved by publishing each version to a separate space with the help of Scroll Versions. The content on this published Confluence page is then added to a second "view" and presented with a custom Scroll Viewport template.

Scroll Versions is available for Confluence Server and can be tried out for free from the Marketplace.


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
Posted Wednesday in Teamwork

What teamwork quotes inspire you?

Hey everyone! My name is Natalie and I'm an editor of the Atlassian Blog and I've got a question for you: What's your favorite quote about teamwork?  We've compiled a list here, along with...

140 views 16 7
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