Relations

Who can use this: Roles that can manage content types can add relation fields. Anyone who can edit entries can set the links.

A relation links entries of one content type to entries of another: an article to its author, or a product page to its category. You add one field, and both sides can use it.

Add a relation field

1. Open CMS, choose Manage Types and select a content type.

2. Click Add Field and choose Relation.

3. Name the field, for example author.

4. Under Relation Type, choose how many entries each side can have.

5. Under Target Collection, choose the type to link to.

6. Leave Reverse field on target on if you want the link visible on the other type.

7. Click Save Changes.

Choose a relation type

• One To One: each entry links to one entry on the other side, and that entry links back to one. A person and their profile.

• One To Many: an entry links to many, and each of those links back to one. A category and its articles.

• Many To One: an entry links to one, and that entry can be linked from many. An article and its category.

• Many To Many: entries on both sides can link to many. Articles and tags.

Edit links from either side

Open an entry on either type and set the relation field. It is the same link, stored once, so a change on one side shows on the other.

When a side can hold only one link, choosing an entry that is already linked elsewhere moves it. The old link is removed.

How it works

The field you add is the owning field. The field created on the target type is the reverse field.

• The reverse field is marked Reverse relation in the Content Type Manager.

• You can rename a reverse field. Its type and target are set on the owning field.

• You cannot delete a reverse field directly. Remove it from the owning type, or turn off Reverse field on target there.

Limits and good to know

• Turning off Reverse field on target removes the reverse field only. Your links stay.

• Deleting an entry removes its links on both sides.

Warning: Removing an owning field, or pointing it at a different target, removes its reverse field and deletes the links it held.

Related

• Content types and fields

• Write and publish entries