# Custom Objects

### Overview

Custom objects let you define your own data types in Pylon beyond the built-in Account, Contact, and Issue objects. Each custom object type has its own records, custom fields, and is usable across the product in filters, views, AI, and more.

<figure><img src="https://982123570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9hXBoCTTNw5flARlUVJf%2Fuploads%2Fs98ggCLy3jOxBGpcnkBj%2FScreenshot%202026-04-14%20at%208.41.34%E2%80%AFPM.png?alt=media&#x26;token=d66dac5c-1777-463d-a38a-549692f6e82c" alt=""><figcaption></figcaption></figure>

You can create and manage custom object definitions in [Settings > Account Data > Objects](https://app.usepylon.com/settings/account-data?tab=objects).

### Creating a Custom Object

1. Go to **Settings > Account Data > Objects**
2. Click **Create Object**
3. Fill in the object details:
   * **Label** — The display name for your object type (e.g., "Project", "Subscription")
   * **Description** — An optional description of what this object represents
   * **Icon URL** — An optional icon to visually distinguish this object type
   * **Visibility** — Choose whether this object appears in the account sidebar, issue sidebar, or both

### Syncing from CRM

Custom objects can be synced from your [crm](https://docs.usepylon.com/pylon-docs/integrations/crm "mention"), allowing you to pull CRM-specific data into Pylon automatically.

To set up a sync:

1. Go to [Settings > Integrations](https://app.usepylon.com/apps) and select your CRM
2. In the **Data Mapping** section, click **Add Object**
3. Select the CRM object you want to sync from
4. Map it to an existing Pylon custom object, or create a new one directly from the sync setup
5. Save your changes

Once configured, Pylon will automatically pull records and field values from your CRM. You can also configure bidirectional sync of fields on the object.

### Using Custom Objects

Once you have custom objects set up, they integrate across Pylon just like built-in object types, for example:

* **Custom Fields** — Add additional [custom-fields](https://docs.usepylon.com/pylon-docs/platform/custom-fields "mention") to add properties to custom objects.
* **Filter and sort** — Use the filter bar and column sorting to find specific records in the table view. Customize which columns are visible and reorder them to fit your workflow.
* **Analytics** — Custom object data flows into your analytics and reporting, so you can build views and track metrics around your custom data.
* **Triggers** — Reference custom object fields in triggers to automate workflows based on your custom data.

<figure><img src="https://982123570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9hXBoCTTNw5flARlUVJf%2Fuploads%2FeZD5zmPrIYlxkEfHPZK5%2FCleanShot%202026-04-14%20at%2022.42.55%402x.png?alt=media&#x26;token=0fcc6a3b-7cd2-4fb0-87ba-3adb60d49be0" alt=""><figcaption></figcaption></figure>