Knowledge Base

Related Content

Last Modified:
01 Jul 2022
User Level:
Power User

Description

The Related Content Navigation Object retrieves content from a specified Section (Branch, level, or other) so it can be re-used in other locations of the site.

Apart from the content re-use, this can also be used to control edit rights to a page by allowing a user access to edit the main content area on the page and populating the page with content from other parts of the site, managed by another user.

How to create a Related Content object

To create this object, go to Assets > Navigation and click Create new navigation and select Related Content.

After completing the standard options used for all types of Navigation Objects, fill in each of the following, where relevant.

Item Description
Output title Add a title which appears before the content pulled by the object.
Fetch method
  • Use current: Includes content from the current section only.
  • Use section: Only content from that exact section is output. Select section - Browse or run a Search.
  • Use child: Output content from a child section with a specific name.
  • Use grandchildren: Output content from a grandchild section with a specific name.

From 8.3.12, fetching Grandchildren with this Navigation Object is deprecated and this will be removed from a future release.

Recurse hierarchy to find child section This appears if the fetch method is Use child. If the current Section does not have a child Section of the specified name, the object will check the parent for a child Section of the specified name. If the parent does not have a child of the specified name, the object will check the parent's parent for a child Section of the specified name etc. until it finds a child Section of the specified name.
Child section name This appears if the fetch method is Use child or Use grandchild. Specify the name of the child Section to use.
Content types This appears if the fetch method is Use child or Use grandchild. Restrict the object to only return content using the selected Content Type(s).
Display This appears if the fetch method is Use child or Use grandchild. Specify the number of Content Items to display.
Display "more" link This appears if the fetch method is Use grandchild. Display a link when more Content Items are available than displayed by the object. The link displays below the grandchild section.
Text for link This appears if the Display "more" link is checked. Specify the text for generated link. For a multi-lingual site use a separate navigation object, using one for each language and a different name of the child section for each language.
Search upwards This appears if the fetch method is Use grandchild. Similar to the Recurse hierarchy to find child section option, this allows the object to search up the site structure for content.
Levels This appears if the Search upwards is selected and specifies the number of levels to recurse upwards. If set at 0, it will search all Sections with no restrictions.
Hidden sections name Checkbox to output the Section name of grandchild Sections as the heading.
Content layouts Use Channel default (specified in the channel settings) or select alternate Content Layout.
Alternate content layout If the Channel default is not used, enter the name of the alternate Content Layout to be used.
Before HTML HTML output before the Navigation Object.
After HTML HTML output after the Navigation Object.
Before grandchild HTML This appears if the fetch method is Use grandchild. Enter the HTML to be used before each grandchild Section.
After grandchild HTML This appears if the fetch method is Use grandchild. Enter the HTML to be used after each grandchild Section.

Review your entries and selections, if you are satisfied with your entries, click Next to generate the object.

Once generated, highlight the T4 Tag Embed Code, copy to your clipboard (Ctrl+C) and paste into a Page Layout or Content Layout or a Content Item.