---
title: Working with page relationships
related:
  - https://docs.kentico.com/13/developing-websites/defining-website-content-structure/managing-page-types/reusing-existing-page-content.md
  - https://docs.kentico.com/13/developing-websites/retrieving-content/displaying-reusable-content-and-related-pages.md
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

Using named relationships, you can add relationships between pages in your website's content tree. Page relationships allow your site's developers to work with connections between pages in custom logic (API).

Page relationships by themselves only define a specific relationship between pages. There is no inherent functionality associated with pages connected in such a way. Your website needs to be configured by the developers to leverage these connections in a meaningful way. For example, your site's developers may use relationships to display links within sidebars or other navigation elements.

## Defining page relationship types

Before connecting pages using relationships, you need to set up the relationship types (names) in the system. There are no restrictions on the number of different relationship types between pages.

1. Open the **Relationship names** application.
2. Click **New relationship name**.
3. Type a **Display name** for the relationship type.
4. Click **Save**.
5. Switch to the **Sites** tab and add all sites where you wish to use the relationship.

You can now create relationships of the given type between pages.

## Creating relationships between pages

To connect two pages through a relationship:

1. Open the **Pages** application.
2. Select one of the pages in the content tree.
3. Switch to the **Properties -> Related pages**tab.
4. Click **Add related pages**.
5. Choose the **Relationship name** (type).
6. Select the other related page on the right side of the relationship (type the alias path or click **Select page**).
7. Click **Save**.

The two pages are now related. The relationships are not symmetrical – each relationship has one of the pages on the left side and the other on the right. Add any number of relationships to pages.

![Adding relationships between pages](https://docs.kentico.com/docsassets/13/working-with-page-relationships/Document_Relationships.png "Adding relationships between pages")

> **Info:** **Note**
>
> - Creating and removing relationships between pages is not a versioned operation. For pages under [workflow](https://docs.kentico.com/13/managing-website-content/working-with-pages/using-workflows.md), changes to relationships are immediately reflected on the published version of the pages.
> - On [multilingual websites](https://docs.kentico.com/13/multilingual-websites.md), page relationships are shared between all culture versions of pages. For example, if you add relationships to an English version of a page, the same relationships are also added for all other culture versions.
> - [Copying pages](https://docs.kentico.com/13/managing-website-content/working-with-pages/copying-and-moving-pages-creating-linked-pages.md) does not transfer page relationships. The new copy is considered as a separate page from the original. You can manually add the same relationships (or different ones) as required.