Skip navigation

Link related content together

Martina Farkasova
4 min read
Download PDF

Your existing content, whether it's articles, case studies, or products, is usually topically related. In Kontent.ai, 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.

Table of contents

    How content linking works

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

    Video about linking content together in Kontent.ai

    Play video on https://www.youtube.com/watch?v=uW-uvPkLRDE

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

    1. In  Content model, open a content type for editing.
    2. Add a Linked items element.
      1. Name it Related articles.
      2. Limit the element to the Article content type.
    3. Click Save changes.
    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.

    Link content together

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

    1. In  Content & assets, open an article for editing.
    2. In the Related articles element, click Add existing items.
    3. Select one or more existing articles.
    4. Click Add.
    Related articles element used 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're 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 the 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.

    Visualize your linked content

    In  Content & assets > Relations, you can view your linked content as a hierarchy of items. The hierarchy is created from the items linked in linked items elements and items inserted in rich text elements.

    The top content item of the hierarchy is called a Home item. This can be your landing page, the main screen of your app, or anything else 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 link to other items, they can be expanded using the icon next to their name.

    Choose a default home item for everyone

    For every project, you can choose a default home item by clicking > Set as default. This way users who open the Relations tab for the first time see the hierarchy for the home item you chose.

    Users can also select their own home item, which will be visible only to them.

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

    Change your home item

    1. In  Content & assets > Relations, click .
    2. Select Change your home item.
    3. Select your new home item from the list.

    If you want to revert to the default home item, click and select Back to default.

    What's next?