Skip navigation

Link related content together

Your existing content, whether it's articles, case studies, or products, is usually topically related. In Kontent, you specify these relations using linked items. You can use this approach to feature related products on an e-commerce site or provide a list of related articles. Let's see how it all works with related articles.

Table of contents

    How content linking works

    Watch this video to get familiar with the concept of linking content together.

    First, you need to add a linked items element to a content type. This will allow your content creators to specify the related items.

    1. From the app menu, choose .
    2. Open a content type for editing.
    3. Add a Linked items element.
      1. Name it Related articles.
      2. Limit the element to the Article content type.
    4. Click Save changes.
    A screenshot of a Related articles element in a content type.

    Now that you've added a way to specify related articles, you can open an article you want to link with the related content.

    To add related articles to an existing article in your project, you'll use the new linked items element.

    1. From the app menu, choose .
    2. Open an article for editing.
    3. In the Related articles element, click Add existing items.
    4. Select one or more existing articles.
    5. Click Add.
    A screenshot of a Related articles element in a content item.

    In the picture, you can see how the final result could look on a website.

    A screenshot of the article on our sample website.

    Manage your linked content

    After adding the articles, you can reorder, remove, or expand the items to view their content. To edit a linked item, click  to open the content item for editing.

    The linked content items are independent and can be accessed outside the content items they are used in. This means you only need to edit a specific linked item once and the changes will be automatically reflected everywhere. You can also publish all linked items along with your original article.

    Making changes to published content

    Once your article is published, you cannot make any changes. To add new related articles to a linked items element or update the article itself, you first need to create a new version of the item or unpublish the item.

    See how your content is linked together

    Once your project starts growing, you might find it harder to navigate through all your linked content. This is where the Relations tab can come in handy. With a home item all set up, you can see the relationships of your linked items and what the structure of your website looks like within Kontent.

    The Relations tab is a tool that provides you with a different view of your content items list. It can be used to display the hierarchy of the selected content item and its related items. The relationships between items can be created either by using linked items elements or by inserting the existing content items directly into a rich text element.

    The top content item of the hierarchy is called a Home item. It could be a content item representing your landing page, the main screen of your app, or basically anything that's on the top of your content structure.

    Showing relations for the Home item.

    Under the home item, you can see all the content items that are linked inside. If some of these content items themselves have linked items inside, they can be expanded using the icon next to their name. Clicking the content item will redirect you to this item's editing page.

    In each one of your projects, you can set up a default home item that the project members will see when opening the Relations tab for the first time. However, you can also select your own home item, which will be visible only to you.

    Users with the Manage development settings permission can set their home item as a default home item for everyone in the project.

    Changing your home item

    To change the home item:

    1. From the app menu, choose .
    2. Click the Relations tab.
    3. Click .
    4. Select Change your home item.
    5. Select your new home item from the list.

    If you decide to return back to the default home item, you can do this by clicking and selecting Back to default.

    What's next?

    Check out other examples of using linked content: