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

# How to create and manage custom objects

> Admins: create a custom object type, choose which objects it can link to, and edit or delete it from Settings > Manage Objects.

> [!NOTE]
>
> Custom objects are in a limited release for select Enterprise customers. To create or change custom object types, your role needs the **Create custom objects** permission, which admins have by default.

[Set up your first custom object](https://www.youtube.com/embed/MA1jic90Wv4)

## Create a custom object type

1. Go to **Settings** > **Manage Objects**.
2. Click **New Custom Object**.
3. Under **Configuration**, fill in:
   * **Singular Noun**: what one record is called, for example *LP*. Up to 50 characters, and it must be unique.
   * **Plural Noun**: what several records are called, for example *LPs*.
   * **Description** (optional): what this object is for.
   * **Color** and **Icon**: how the object appears across Affinity. The preview next to the form shows your choices.
4. Click **Create**.

Your new object appears in the **Manage Objects** table with the type **Custom**, and a directory for it appears under **Custom Objects** in the left navigation.

> [!TIP]
>
> Each organization can have up to 10 custom object types. If you've reached the limit, you'll see "This organization has reached its limit of 10 custom object types."

### Add fields

Fields aren't set up on this page. Add them from a list or directory of your new object, the same way you add a column to any New List. See [How to create and delete fields in New Lists](https://support.affinity.co/s/article/How-to-create-and-delete-fields-in-new-lists.md) and [How to work with custom object records](https://support.affinity.co/s/article/How-to-work-with-custom-object-records.md).

Once an object has fields, you can change their order and choose which ones are required when someone creates a record. See [Edit a custom object type](#edit-a-custom-object-type).

## Choose which objects it can link to

Before anyone can link records with a relational field, an admin chooses which object types can connect to each other.

1. In **Manage Objects**, click **Edit** next to your custom object.
2. Open the **Related Custom Objects** tab.
3. Click **Relate custom object** and choose an object from the list. It's added straight away.

You can relate a custom object to people, organizations, opportunities, other custom objects, or to itself. The connection shows on both objects' **Related Custom Objects** tabs.

Users can then create relational fields between the two types. See [Relational fields for custom objects](https://support.affinity.co/s/article/Relational-fields-for-custom-objects.md).

To remove a related object, first [delete the relational fields](https://support.affinity.co/s/article/Relational-fields-for-custom-objects.md#delete-a-relational-field) between the two objects. Then click the remove icon next to it, and click **Unlink**.

## Edit a custom object type

1. In **Manage Objects**, click **Edit** next to the object.
2. On the **Configuration** tab, change its names, description, color or icon, then click **Save changes**.
3. On the **Field Management** tab, change the order of the object's fields and choose which ones are required at creation, then click **Save changes**.

Fields appear on the **Field Management** tab once they've been created in the object's lists or directory.

## Delete a custom object type

Deleting a custom object type is permanent. Before you can delete it:

* All of its records must be deleted.
* All lists of its records must be deleted.

Then:

1. In **Manage Objects**, click **Edit** next to the object.
2. Under **Delete Custom Object**, click **Delete**.
3. Confirm in the dialog.

If records or lists still exist, Affinity tells you what to remove first.

## FAQ

**Can I change a built-in object like Person or Organization here?**

Partly. Person, Organization and Opportunity are listed as **Standard** objects. Their name and appearance are set by Affinity and can't be changed, but you can click **Edit** next to one and use its **Related Custom Objects** tab to choose which custom objects it can link to.

**Who can see custom objects?**

Every user in your organization can see custom object directories and records, apart from collaborators. Lists of custom object records follow the usual [list sharing](https://support.affinity.co/s/article/How-to-share-lists-in-Affinity.md) settings.


## Related topics

- [Custom objects overview](https://support.affinity.co/s/article/Custom-objects-overview.md)
- [Relational fields for custom objects](https://support.affinity.co/s/article/Relational-fields-for-custom-objects.md)
- [Navigating Your Settings In Affinity](https://support.affinity.co/s/article/Navigating-your-settings-in-Affinity.md)
- [Account Level Permissions](https://support.affinity.co/s/article/Account-level-permissions.md)
- [How to work with custom object records](https://support.affinity.co/s/article/How-to-work-with-custom-object-records.md)


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