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

0 vote
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?

Anh Khoa I'm New Here Jan 04, 2018

@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 @Anh Khoa, 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 Join to answer
Community showcase
Alexey Matveev
Published Saturday in Jira

How to run Jira in a docker container

Everything below is tested on Ubuntu 17.10. I prefer to use Jira in a docker container because: 1. I can install Jira with a couple of commands. 2. I can start and stop Jira just by starting and s...

95 views 2 5
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
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot