Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Search by comments in page history / previous versions


We currently add our dev job numbers to page labels so that we can search for all pages relating to a job (User Guides, Support docs etc).

However this isn't sustainable as the number of jobs/labels for once page increases and it also fills up our word maps with numbers instead of words.

I thought I had the answer by only adding the job number to the comments when editing a page (which is great for page history & version control) but it seems only the comments in the current version of a page are included in searches rather than all versions.

Is it possible to extend search to include comments on previous versions of pages or is there another way to tag a page with a dev number it can be searched by which doesn't clutter up the labels?

1 comment

The Page Properties Macro and Page Properties Report Macro may be helpful for your use case. The first macro allows to add properties on a page that can be used in the report with the second.

Another solution could be the projectdoc Toolbox, a commercial plugin for Confluence server available on the Atlassian Marketplace, with similar features provided by the Document Properties Marker Macro and the Display Table Macro.

Biased alert: I'm one of the authors of the projectdoc Toolbox! :)

Thanks for the suggestion but the Page Properties Report is still based on a common label. 

I think my best option for searching by Job ID instead of label is just listing the Job IDs inside an Info macro in each page. However it seems like I'm best off continuing to clutter up the labels/heatmaps with Job Ids in order to see all pages related to a job.

Users will then have to view the Page History comments and compare versions if they want to see which change the job relates to.

As I understand the page properties macro, there is indeed one label required. But you can have additional properties in the table. One of these properties could be the Job ID and I thought you can use this property in your queries (see CQL fields). Maybe I am wrong ... ? Since I'm using our own macros for this use case I'm sorry if I remembered incorrectly.

The Display Table Macro definitively allows to select on any property defined with the Document Properties Marker Macro. And there is no need for an extra label. But this would require to install one additional (commercial) add-on.


Log in or Sign up to comment
Community showcase
Published in Confluence

Confluence: Where work and wellness meet

Feeling overwhelmed by the demands of work and life? With a 25% increase in the prevalence of anxiety and depression worldwide during the pandemic, for most of us, it’s a resounding yes . 🙋‍♀️ ...

779 views 5 21
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