Defining page and user filters

For every rule you create, you have to define which users should receive a training notification and for which pages.


  1. Create or edit a rule.
  2. Select Page filters.
  3. To add just one criterion, choose Add filter:
    1. In the Type column, select the type of filter you want to use.
    2. In the Value column, enter the value you want to use.
      For example, you choose the type Pages label and the value training_employees. This rule will apply to all pages with the page label training_employees.
  4. To add multiple filters, choose Add group:
    For example, you want the rule to only apply to pages with the training_employees label, if they are also part of the hr space.
    1. In the Type column, select how the filters should be used:
      • All criteria need to exist: A page or user needs to match all of the filters to be considered.
        For example, a page needs to have the right page label and be in the right space.
      • Any criteria need to exist: A page or user needs to match at least one of the filters to be considered.
        For example, a page needs to have the right page label or be in the right space.
    2. Choose Add filter to add a filter to the group and specify the type and value.
    3. If necessary, add more groups and filters to combine filter options.
  5. Select User filters and follow the same steps as with Page filters.
    For example, you choose the type User group and the value training users. Only users who belong to this user group will receive notifications.
  6. Choose Save.

Page filters

Pages space nameThe rule looks at the space name.
Example: You collect all your trainings in a space called Documents
Pages space keyThe rule looks at the key associated with the space. This can be useful if the name of a space can change or is not unique.
Example: The name of your space is still a draft, so you use the unique space key 'DOCS'
Pages labelThe rule looks at labels you've attached to certain pages. This can be useful if you don't want to limit your training documents to one particular space.
Example: You give all your training pages the label 'training'.
Pages cql

This rule searches pages using a CQL clause. Refer to Atlassian documentation for complete CQL syntax.

Example:  'type=page' will retrieve all pages in your instance.

Pages metadata

This rule searches pages have metadata. The metadata it refers to is the one provided by Comala Metadata. You can use regex when referencing to metadata values.

Example: 'doc type=.*' will retrieve all pages who have the 'doc type' metadata set, whatever the value.

All pagesThe rule applies to all pages.

User filters

User groupThe rule looks at the user group people belong to. 
Example: You create the "training group" user group and add all the people who should receive training to this group.
User email domain

The rule looks at the domain name of the email address associated with a user's Confluence account.
Example: Only people from Radbee should receive training on particular pages, so you only want people whose email address ends in "".

Do not include "@" in the value.

All usersThe rule applies to all users.