> ## Documentation Index
> Fetch the complete documentation index at: https://support.affinity.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Relational fields for custom objects

> Link custom object records to people, organizations, opportunities and other custom objects with relational fields.

> [!NOTE]
>
> Relational fields are part of the custom objects limited release for select Enterprise customers.

## What is a relational field?

A relational field links a record to other records. For example:

* An **LP** with a *Commitments* field that links to its Commitment records
* A **Portfolio Fund** with a *Portfolio Companies* field that links to organizations
* An **Event** with an *Attendees* field that links to people

You can link custom object records to people, organizations, opportunities and other custom objects.

[Link records with relational fields](https://www.youtube.com/embed/Nde472Hkg50)

## Before you start

An admin must first allow the two object types to relate to each other, from **Settings** > **Manage Objects** > **Edit** > **Related Custom Objects**. Only those objects appear when you create a relational field. See [How to create and manage custom objects](https://support.affinity.co/s/article/How-to-create-and-manage-custom-objects.md#choose-which-objects-it-can-link-to).

## Create a relational field

1. Open a list or directory of custom object records.
2. Click the **+** at the end of the column headers.
3. Under **New relational field**, choose the object you want to link to.
4. Choose a **Relationship type**, then click **Next**:
   * **Both ways** adds a field on both objects, so the link shows on both sides.
   * **One way** adds a field only on this object. Nothing shows on the other side.
5. Configure the field on this object:
   * **Name**: how the field is shown. The default is *Related* followed by the other object's plural name.
   * **How many can be linked**: **Multiple** or **Single**.
   * **Where this field appears** (when you start from a list): **Global**, or **List Specific** to show it only on this list.
6. Finish creating the field:
   * For a **One way** field, click **Create field**.
   * For a **Both ways** field, click **Next**, configure the matching field on the other object, then click **Create field pairs**.
7. Click **Save** on the view to keep the new column.

For example, an **LP** can link to **Multiple** commitments, while each **Commitment** links to a **Single** LP.

> [!TIP]
>
> * When you start from a custom object, a field that links to **opportunities** can only be one way. To link both ways, create the field from the opportunity list instead.
> * A field that links an object to **itself** always shows on both sides.
> * In a two-way field, the matching field on the other object always appears globally.

The matching field on the other object isn't added to that object's views automatically. To show it, click **+** in that list or directory, choose it under **Add an existing field** > **Relational fields**, then click **Save**.

## Link records

1. Click a relational field cell.
2. Search for a record and choose it. For a **Multiple** field, repeat to add more.
3. To remove a link, click the remove icon next to the record under **Already selected**.

For a two-way field, the link shows on both sides, in each object's directory and lists.

To see how a field is set up, hover over its column header. The details card shows both sides of the relationship.

## Delete a relational field

Deleting a two-way relational field deletes the fields on both objects and every link stored in them. You'll be asked to type the field name to confirm.

## Limits

* You can't yet link people, organizations and opportunities to each other with relational fields.
* You can't filter or sort by relational fields yet.
* Relational fields and their values don't show in a record's side panel or page yet. Use the directory or a list to see them.
* Lookup fields (showing a field from a linked record) and rollup fields aren't available yet.


## Related topics

- [How to create and manage custom objects](https://support.affinity.co/s/article/How-to-create-and-manage-custom-objects.md)
- [How to work with custom object records](https://support.affinity.co/s/article/How-to-work-with-custom-object-records.md)
- [How To Set Up Affinity For Salesforce](https://support.affinity.co/s/article/How-to-set-up-Affinity-for-Salesforce.md)
- [Custom objects overview](https://support.affinity.co/s/article/Custom-objects-overview.md)
- [Lists](https://support.affinity.co/s/article/Lists.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.