Versions Compared

Key

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

Knowledge Base contributors can add filters using Confluence's Content By Label macro.  

In the majority of the support articles on the Knowledge Base, there is a section called "Related Articles." This section is populated by content by using the Content by Label macro. The macro surfaces articles that have labels that you specified in the macro. At times, the default settings can return too many results or ones that are not very relevant. You can better focus the macro by refining the labels listed and by adding filters. This article covers how to focus results by adding the "In Space" and "Parent filter" filters. Other filters, such as "With Ancestor," can be useful when you want to span multiple levels of articles.

...

By adding this filter, you limit the results to the desired space.

Note

You must be in edit mode to follow these instructions. 

To proceed, 

  1. Left-click on the

    content

    Content by

    label

    Label macro.

  2. Click Edit. 

  3. In the pop-up window, click Add a filter. 

  4. Scroll down to select In Space. 

  5. Choose either Current space or scroll down under Suggested Spaces for IT Knowledge Base.

  6. TipWhen you are in the Content by Label Macro, click

    Click Preview to see the results generated. Then, you can make adjustments while in the macro.

Adding the With Parent Filter

Note

You must be in edit mode to follow these instructions.

 

...

 

  1. Left-click on the

    content

    Content by

    label

    Label macro.

  2. Click Edit. 

  3. In the pop-up window, click Add a filter. 

  4. Scroll down

    to

    , and select With Parent. 

  5. The page will display a drop-down list of articles, but you must type in the name of the parent article for the article you are currently working on.

     When

    When selecting the parent page for the filter, ensure that "ITS

    knowledge

    Knowledge Base" is listed right below the name of the page.  

  6. Click Save. 

Example

In the example below, "NetID" is the parent article of the article that I was working on, so "NetID" is selected as the parent article for the filter. decorativeImage Removed

...

Filter by label (Content by label)
showLabelsfalse
max10
showSpacefalse
cqllabel in ( "kb" , "knowledge_base" , "knowledgebase" , "filters" , "filtering" ) and space = "IKB

...

"
Page Properties
hiddentrue