Linking

Martina Farkasova, Jan Cerman
7 minutes
Linked items
Your existing content, such as articles, case studies, or products, is 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.
Explore your path to mastery

How content linking works

Watch this video to understand the concept of linking content together.
To create relations between items, you need to add a linked items element to a content type. With related items, your content creators can specify the related content.
  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, for example, the Article content type.
  3. Click Save changes.
With the linked items element, you now have a way to specify related articles.
Related articles element in a content type.
With the native AI accelerators, you can let AI suggest linked items relevant to the article you're editing based on its content.
To suggest linked items with AI, you need to activate it in Innovation Lab.Once activated, it reads through your content items to index them. Depending on the number of items in your project, this can take up to a couple of hours. Your content stays as-is.
  1. In  Content & assets, open an article for editing.
  2. In the Related articles element, click Suggest with AI.
  3. Select an existing article.
  4. Click Add.
The suggestions are available for any linked items element in your content items.
Related articles element used in a content item.
To add existing related articles to an article, use the 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.
  1. In the Related articles element, click Create new item.
    1. If multiple workflows are available, select one for the new content item.
    2. Type a name for your content item.
    3. Insert all the content you want in your new related article.
  2. Click in the top left to return to the parent article.
  3. (Optional) Publish the new version of your article. You can select unpublished related articles and publish them together with their parent article.
New linked items inherit the collection of their parent itemTo change the item’s collection, open the linked content item and move the item to a different collection. You can also do that for already published items without creating a new version.

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