Adding Filters in the Content By Label Macro

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

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.

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

Adding the With Parent Filter

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.

Related Articles

Related content

Contributing to the Knowledge Base
Contributing to the Knowledge Base
More like this
Insert Dynamic Content with Macros in the Knowledge Base
Insert Dynamic Content with Macros in the Knowledge Base
More like this
Different Roles in HuskyCT
Different Roles in HuskyCT
Read with this
Links Guide: UConn Knowledge Base
Links Guide: UConn Knowledge Base
More like this
Images Guide: UConn Knowledge Base
Images Guide: UConn Knowledge Base
Read with this
Labeling Guide
More like this