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

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-flexcollapsiblecollapse
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

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

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