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. Other filters, such as "With Ancestor," can be useful when you want to span multiple levels of articles.

Adding the In Space Filter

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

Note
You must be in edit mode to follow these instructions. 
  1. Left click on the Content by 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.

    Tip

    When you are in the Content by Label Macro, 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 by Label macro.
  2. Click Edit. 
  3. In the pop up window, click Add a filter. 
  4. Scroll down, 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 selecting the parent page for the filter, ensure that "ITS 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. 

Select the appropriate Parent article to filter by.

Filter by label (Content by label)
showLabelsfalse
showSpacefalse
cqllabel in ( "kb" , "knowledge_base" , "knowledgebase" ) and space = "IKB" and parent = "77400063"

Page Properties
hiddentrue