Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Content Layer
namePage Info
id278129461
classwatermark-layer
Content Column
namePage Body
width100.00001%
id278129463
Content Block
background-colortransparent
namePrompt
id494677873
classtight manual-prompt-flex

Establishing chosen words for labeling and filtering content.

Content Block
nameOutcome
rich-link-hoverstrue
id1042866408
classtight manual-outcome-flex

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 chances 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 groupReplace me with a more complete explanation of what this how-to accomplishes.

Content Block
nameSteps
rich-link-hoverstrue
id494842117
classsteps-block numbered tight-bottom manual-steps-flex

Decide where the filter/predefined label belongs in your site's taxonomy

Navigate to the Targeted Search Filters page to view 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 appropriate filter group

Click the gear icon Image Added 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 Resources) as well as the actual label string (e.g., human_resources).

Add a nested filter group

You can create filter groups within filter groups (called "subcategories"). Subcategories are always created under a filter. If you haven't done so, create a filter first, then click the gear icon Image Added next to this filter. Select "Add subcategory". You will be prompted to enter a human-friendly name and an optional prefix. The prefix is added to each of the filters within this subcategory

Use h4 for section headings

If you don't want numbers in the section headings, simply remove the "numbered" class from this block.

Note/Tip/Warning/Info blocks below are collapsed by default. If you want to use any of these, try to keep to just one per page. You may use two if necessary, but in general, try to limit these.

Content Block
nameNote
rich-link-hoverstrue
id495965127
classmanual-note-flex
collapsiblecollapse
Note

Confluence's search engine breaks apart text strings that are separated by hyphens.

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 recommend using underscores (_) instead (e.g., part_time, world_class).

The corresponding human-friendly name for any filter can include hyphens, spaces, and uppercase letters (e.g., Part-Time, World Class)

Note

If using:

  • Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  • Add the tight-bottom class to the Steps block above to narrow the gap between the two blocks

    .

    Content Block
    nameTip
    rich-link-hoverstrue
    id894522670
    classmanual-tip-flex
    collapsiblecollapse
    Tip

    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.
    Content Block
    nameWarning
    rich-link-hoverstrue
    id894530759
    classmanual-warning-flex
    collapsiblecollapse
    Warning

    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.
    Content Block
    nameInfo
    rich-link-hoverstrue
    id894537203
    classmanual-info-flex
    collapsiblecollapse
    Info

    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.
    Content Layer
    background-color$lightGrayColor
    nameRelated
    id888168050
    Content Column
    nameRelated
    width100%
    id888168051
    Content Block
    rich-links-hide-descriptiontrue
    rich-link-hoverstrue
    rich-links-columns4
    rich-links-verticaltrue
    rich-links-image-height100px
    rich-links-hide-site-icontrue
    rich-links-details-padding10px
    nameRelated
    rich-links-enabletrue
    border-width0
    rich-links-details-alignmentleft
    rich-links-margin20px 30px 0 0
    id496234544
    classrelated-block clean manual-related-flex