Fixed Versions value reference in Confluence

[Maya.Zgrablic]

I have to create 3 templated documents in Confluence for a release.  Fixed versions is referenced multiple times in all of them, including multiple snapshots.  It would be VERY helpful if I could define the value of the Fixed versions for all 3 (or at least just once in every document) for a particular release to be used.

[Tanya - · Accepted solution]

Hey Maya, 

Greetings !! I hope you are doing well. 

I understand you want to use a fixed version, i.e., a fixed value in the Confluence Pages/Documents. 

Details: 

You can achieve your goal of referencing the "Fixed Versions" value multiple times across Confluence documents by using Confluence's content re-use features:

• Excerpt Macro: Place the "Fixed Versions" value inside an Excerpt macro on a dedicated page.

• Excerpt Include Macro: In your templated documents, use the Excerpt Include macro to pull in the value wherever needed.

This way, you only need to update the value in one place, and it will automatically update everywhere it's referenced. This approach is ideal for values like release numbers or fixed versions that appear in multiple documents or multiple times within a document.

If you have several templates, you can either:

• Reference the same excerpt in all templates, or

• Create a new excerpt for each release and update your templates to include the relevant one.

This method saves time and ensures consistency across your documentation. 

Further, you can also refer:  Use Confluence for technical documentation

I hope the above details help and suffices your query. 

Regards, 

Tanya

[Maya.Zgrablic]

Thank you Tanya

[Anatolii Starshekov]

Hey, @Maya.Zgrablic

That’s definitely a relatable task!

Using excerpts is a solid workaround if you’re dealing with dynamic or shared content. But while experimenting with an app we’re developing, I explored another approach using page labels.

You can assign a label like fixed-version_1.2.3 to a page, and then utilize a user macro that checks for it — first on the current page, and if not found, it walks up the parent pages (all the way to the space homepage if needed). This lets you define the version once and have it referenced inline across all your pages.

If that’s the case, you might give it a try and let me know if you need more details.

[Maya.Zgrablic]

Thank you Anatolii, will definitely try that.