Versions Compared

Key

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

All articles in our knowledge base must have the "With Parent" filter turned in the content by label macro. The parent article that is chosen for that filter must be the parent article for the article you are currently working with, not an ancestor article. 

Adding The "With Parent" Filter in the Content By Label Macro

All of the instructions here should be followed while in edit mode. 

...

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.

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.

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

    click

    select With Parent. 

  5. It

    The page will

    present

    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

    it says

    "ITS

    knowledge

    Knowledge Base"

     right

    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 I "NetID" is selected that as the parent article for the filter. 

Image Removed

I was working on "Changing Your NetID Password." 

Image Removed

...

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