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".

Due to an issue in Confluence, labels with hyphens, such as part-time or world-class, are broken apart by the search engine (becoming part, time, world, and class).

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.
  • Replace me with a link
  • Replace me with a link
  • Aim for 4 or fewer related links.  If we need more, that's okay.  Be judicious.  Delete me when you're done.