Creating and Managing Predefined Labels or Filters
Establishing chosen words for labeling and filtering content
Although Confluence allows users to add and use labels in a free-form manner, in many cases it is better to create labels ahead of time so that content can be labeled from a predefined set of terms, thereby decreasing the changes of content being labeled incorrectly or inconsistently. These predefined labels, or filters, can also be used to narrow search results.
Adding a new filter to your site's taxonomy is simply a matter of placing it in a filter group.
Decide where the filter/predefined label belongs in your site's taxonomy.
Navigate to the Targeted Search Filters page to all existing filter groups. Is there already a filter group for this new filter? If not, you may need to create a new filter group.
Add the filter to the filter group.
Click the gear icon that corresponds with your chosen filter group and select "Add Filter". You will be prompted to enter a human-friendly name for this filter (e.g., Human Resource) as well as the actual label string (e.g., human_resources).
See note below about using hyphens in labels.
Edit or delete the filter as necessary.
Click the gear icon that corresponds with the filter to edit or delete the filter.
Note that editing the label associated with a filter is essentially the same thing as creating a new label. Any pages, blog posts, attachments, and spaces that were labeled with the old label will remain labeled with the old label. Changing the value of a filter's label simply disassociates the old label from the filter.
For example, you may have a "Human Resources" filter with the label, "human_resources", and a page that is labeled with it. Changing the "Human Resources" filter label from "human_resources" to "hr" will neither change the way that existing page is labeled nor will it remove the original label. That page will still be labeled, "human_resources".
Confluence's search engine breaks apart text strings that are separated by hyphens (CONF-41459). Labels such as part-time or world-class are automatically separated into part, time, world, and class, which can make search results from queries with hyphenated terms less relevant. For this reason, we advise against using hyphens in labels and using underscores (_) instead.
The corresponding human-friendly name for any filter can include hyphens, spaces, and uppercase letters (e.g., Part-Time, World Class).
