automatically adding labels to confluence page

Hi all,

Is there a way to automatically add a label to a page upon creation.  We are wanting to create a retention policy for our site that has a number of settings.  For each space we would want a default retention policy label applied to each page.  So:

Space A: all pages default to rrpolicy1

Space B: all pages default to rrpolicy2

Space C: all pages default to rrpolicy1

I can, with the cli, add a label to each page in a give space through a programmatic method, but newly created pages will not automatically get the new label.

Thanks in advance,



3 answers

1 accepted

Hi Robert

You can do this. What you will want to do is create a new page template within each space. In the template you would include any labels that you wanted. Once created you can click the 'promote' link which will cause the template to be at the top of the list of options when creating a new page.

When someone goes to create a new page within this space, they would simply choose this template to create their page, and the correct labels would automatically be added.

I hope this is what you were looking for.


Is there a way to edit the default templates to simply add a label to them? I really do not know how to recreate the Blog post, decision, etc. pages so that there is a duplicate of each one with a new label. Also is there a way when the page is created to not allow the users to delete the label? IE can I lock the label?

You could also solve it by building a dead-simple Confluence plugin that contains nothing else but an EventListener. The listener should intercept the "page created" events and add the labels trivially.

Another option to consider is to use the Archiving Plugin to implement your retention policies, instead of rolling out some custom solution. With this you can set up policies per space, according to your requirement. Make sure you check it.

An older screenshot about the config options:


I do need to learn to write plugins so that sounds like a good solution as well. As far as the archive plugin, I believe that only archived pages not comments and we are interested at first in only deleting comments.

1 vote
Stephen Deutsch Community Champion Mar 24, 2015

Another option would be to install the Label Tools addon from Adaptavist (, which contains the add-label macro.

Then you would need to get this to display on every page in the space.  If you are still using the documentation theme, then you can just add the macro in wiki markup format in either the header or the footer: 


Or, if you are using the default theme, you will need to change the page layout for the space and add the following line somewhere in the decorator:


Then newly created pages should have the label added to them.

Stephen Deutsch Community Champion Mar 24, 2015

If you don't want to use the Label Tools plugin, I could whip up a user macro that adds a label to the page using javascript, but since it's already there...

I have no problem installing the plug in, especially since it's free. :) Where do I go to edit the header or footer? If I just changed the layout (I do that a lot already) wouldn't that be for all spaces? Ideally I would like a different setting per space.

Ideally I would like to mark both answers as correct as they both solve the problem to an extent, but when I mark the above answer as correct is deactivates this one and vise versa...

Robert, I have encountered the same issue both asking and answering questions. It may be a viable enough issue to place a feature request on it for Confluence Questions (I haven't searched if it already is, but if it is I'll vote for it!).

Suggest an answer

Log in or Sign up to answer
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Posted Jul 10, 2018 in Confluence

We want to see the templates you've created in Confluence!

Hi Community, Jessica here from the Confluence Product Marketing team!  July’s community challenge is all about sharing pictures  — and as an extension of our first post on what ...

788 views 23 12
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