# Custom Objects - Unique Fields Support > Guarantee clean data with Unique Fields for Custom Objects. Block duplicate values across UI, forms, workflows, imports, and API before they reach your CRM. - Source: https://docs.ghlcustomercare.com/docs/custom-objects/managing-custom-object-records/custom-objects-unique-fields-support - Section: Custom Objects. / Managing Custom Object Records - Reading time: 4 min - Images: 7, each explained below - Modified on Thu, 22 Jan at 11:15 AM --- The Unique Fields feature allows you to ensure that specific field values remain unique across all records within a Custom Object. This helps maintain data integrity, prevent duplication, and ensure that identifiers such as IDs or reference numbers are never reused accidentally. This article shows how to use unique fields in custom objects. --- **TABLE OF CONTENTS** - [What is Unique Fields for Custom Objects?](#what-is-unique-fields-for-custom-objects)[](#key-benefits-of-unique-fields) - [Key Benefits of Unique Fields](#key-benefits-of-unique-fields)[](#rules-limits-and-field-support) - [Rules, Limits & Field Support](#rules-limits-and-field-support)[](#how-to-mark-a-field-as-unique-in-custom-objects) - [How to Mark a Field as Unique in Custom Objects](#how-to-mark-a-field-as-unique-in-custom-objects)[](#how-to-modify-unique-fields) - [How to Modify Unique Fields](#how-to-modify-unique-fields)  [](#example-scenarios) - [Example Scenarios](#example-scenarios)[](#best-practices) - [Best Practices](#best-practices)[](#frequently-asked-questions) - [Frequently Asked Questions](#frequently-asked-questions)[](#related-articles) - [Related Articles](#related-articles) --- # **What is Unique Fields for Custom Objects?** Unique Fields is a data-integrity setting that you can enable on selected custom-object fields. When a field is flagged as unique, GHL Customer Care checks every new or updated record and blocks any value that already exists anywhere in the sub-account. This ensures every custom-object record stays truly unique and eliminates messy deduplication projects down the road.  --- ## **Key Benefits of Unique Fields** - **Stop duplicates:** Enforce unique fields at create/update so repeats are blocked across UI, forms, workflows, imports, and API. - **Accurate reporting:** Preserve true one-to-one relationships so dashboards, attribution, and metrics stay trustworthy. - **Safe automations:** Protect bulk imports and workflow actions from accidental double-creates with built-in pre-checks. - **Future-ready:** Establish the foundation for upcoming advanced deduplication and merge tools. --- ## **Rules, Limits & Field Support** - Mark custom fields as unique during creation. - Limit of **10 unique fields per object** (applies across the subaccount). - Enforced across all record creation methods — **UI, Workflows, Forms, and APIs**. - Supported field types: - Single Line Text - Multi Line Text - Number - Phone - Allows downgrading a unique field to non-unique (**irreversible action**). --- ## **How to Mark a Field as Unique in Custom Objects** **Note:** Once saved, this setting applies across all records within the subaccount and cannot be re-enabled once turned off. ### **Option 1:** While Creating a New Custom Field 1. Navigate to **Settings.** ![Step 1 of 7: Navigate to Settings](https://jumpshare.com/share/DJ6UwhUJbbYconMeQoVu+/Screen+Shot+2025-10-15+at+8.08.46+PM.png) **Step 1 of 7: Navigate to Settings** This screenshot accompanies step 1 of 7 in the "Option 1: While Creating a New Custom Field" section of "Custom Objects - Unique Fields Support". At this point in the walkthrough you navigate to Settings. For context, this section explains: Navigate to Settings. Click on Custom Fields. Click + Add Field. Select a supported field type (Single Line, Multi Line, Number, or Phone). Enter the field name, object, and group. Check the box for Mark Field as Unique. Click Save. The next step is to click on Custom Fields. - Where to go: Navigate to Settings. - Controls: Settings., Custom Fields, Add Field, Mark Field as Unique., Save. - Next: Click on Custom Fields. Full procedure: 1. Navigate to Settings. <- this image 2. Click on Custom Fields. 3. Click + Add Field. 4. Select a supported field type (Single Line, Multi Line, Number, or Phone). 5. Enter the field name, object, and group. 6. Check the box for Mark Field as Unique. 7. Click Save. 2. Click on **Custom Fields**. 3. Click + **Add Field**. ![Step 3 of 7: Click + Add Field](https://jumpshare.com/share/dxDG7i3qZfniSBYsEBGf+/Screen+Shot+2025-10-15+at+8.09.55+PM.png) **Step 3 of 7: Click + Add Field** This screenshot accompanies step 3 of 7 in the "Option 1: While Creating a New Custom Field" section of "Custom Objects - Unique Fields Support". At this point in the walkthrough you click + Add Field. For context, this section explains: Navigate to Settings. Click on Custom Fields. Click + Add Field. Select a supported field type (Single Line, Multi Line, Number, or Phone). Enter the field name, object, and group. Check the box for Mark Field as Unique. Click Save. The next step is to select a supported field type (Single Line, Multi Line, Number, or Phone). - What to click: Click + Add Field. - Controls: Add Field, Settings., Custom Fields, Mark Field as Unique., Save. - Next: Select a supported field type (Single Line, Multi Line, Number, or Phone). Full procedure: 1. Navigate to Settings. 2. Click on Custom Fields. 3. Click + Add Field. <- this image 4. Select a supported field type (Single Line, Multi Line, Number, or Phone). 5. Enter the field name, object, and group. 6. Check the box for Mark Field as Unique. 7. Click Save. 4. Select a supported field type (Single Line, Multi Line, Number, or Phone). 5. Enter the field name, object, and group. 6. Check the box for **Mark Field as Unique.** 7. Click **Save.** ![Step 7 of 7: Click Save](https://jumpshare.com/share/BUuYNKbiZTXKsVUBEwpf+/GIF+Recording+2025-10-15+at+8.12.45+PM.gif) **Step 7 of 7: Click Save** This animation accompanies step 7 of 7 in the "Option 1: While Creating a New Custom Field" section of "Custom Objects - Unique Fields Support". At this point in the walkthrough you click Save. For context, this section explains: Navigate to Settings. Click on Custom Fields. Click + Add Field. Select a supported field type (Single Line, Multi Line, Number, or Phone). Enter the field name, object, and group. Check the box for Mark Field as Unique. Click Save. - How to confirm: Click Save. - Controls: Save., Settings., Custom Fields, Add Field, Mark Field as Unique. Full procedure: 1. Navigate to Settings. 2. Click on Custom Fields. 3. Click + Add Field. 4. Select a supported field type (Single Line, Multi Line, Number, or Phone). 5. Enter the field name, object, and group. 6. Check the box for Mark Field as Unique. 7. Click Save. <- this image ### **Option 2:** Marking a Primary Field as Unique While Creating Custom Object 1. Go to **Settings.** ![Step 1 of 7: Go to Settings](https://jumpshare.com/share/DJ6UwhUJbbYconMeQoVu+/Screen+Shot+2025-10-15+at+8.08.46+PM.png) **Step 1 of 7: Go to Settings** This screenshot accompanies step 1 of 7 in the "Option 2: Marking a Primary Field as Unique While Creating Custom Object" section of "Custom Objects - Unique Fields Support". At this point in the walkthrough you go to Settings. For context, this section explains: Go to Settings. Click on Objects. Click on + Add Custom Object. Define the Custom Object Name and Primary Display Field. Check Mark Primary Field as Unique. Click Create Custom Object. This ensures the primary field (for example, Case No. or VIN Number) cannot have duplicates. The next step is to click on Objects. - Where to go: Go to Settings. - Controls: Settings., Objects., + Add Custom Object., Mark Primary Field as Unique., Create Custom Object. - Next: Click on Objects. Full procedure: 1. Go to Settings. <- this image 2. Click on Objects. 3. Click on + Add Custom Object. 4. Define the Custom Object Name and Primary Display Field. 5. Check Mark Primary Field as Unique. 6. Click Create Custom Object. 7. This ensures the primary field (for example, Case No. or VIN Number) cannot have duplicates. 2. Click on **Objects.** 3. Click on **+ Add Custom Object.** ![Step 3 of 7: Click on + Add Custom Object](https://jumpshare.com/share/hK6LRe3RPJWb1Y6dR78A+/Screen+Shot+2025-10-15+at+8.23.59+PM.png) **Step 3 of 7: Click on + Add Custom Object** This screenshot accompanies step 3 of 7 in the "Option 2: Marking a Primary Field as Unique While Creating Custom Object" section of "Custom Objects - Unique Fields Support". At this point in the walkthrough you click on + Add Custom Object. For context, this section explains: Go to Settings. Click on Objects. Click on + Add Custom Object. Define the Custom Object Name and Primary Display Field. Check Mark Primary Field as Unique. Click Create Custom Object. This ensures the primary field (for example, Case No. or VIN Number) cannot have duplicates. The next step is to define the Custom Object Name and Primary Display Field. - What to click: Click on + Add Custom Object. - Controls: + Add Custom Object., Settings., Objects., Mark Primary Field as Unique., Create Custom Object. - Next: Define the Custom Object Name and Primary Display Field. Full procedure: 1. Go to Settings. 2. Click on Objects. 3. Click on + Add Custom Object. <- this image 4. Define the Custom Object Name and Primary Display Field. 5. Check Mark Primary Field as Unique. 6. Click Create Custom Object. 7. This ensures the primary field (for example, Case No. or VIN Number) cannot have duplicates. 4. Define the Custom Object Name and Primary Display Field. 5. Check **Mark Primary Field as Unique.** 6. Click **Create Custom Object.** 7. This ensures the primary field (for example, Case No. or VIN Number) cannot have duplicates. ![Step 7 of 7: This ensures the primary field (for example, Case No. or VIN Number)…](https://jumpshare.com/share/W3HjgnXybCax9NDyZjnw+/Screen+Shot+2025-10-15+at+9.06.03+PM.png) **Step 7 of 7: This ensures the primary field (for example, Case No. or VIN Number)…** This screenshot accompanies step 7 of 7 in the "Option 2: Marking a Primary Field as Unique While Creating Custom Object" section of "Custom Objects - Unique Fields Support". At this point in the walkthrough you this ensures the primary field (for example, Case No. or VIN Number) cannot have duplicates. - What this covers: This ensures the primary field (for example, Case No. or VIN Number) cannot have duplicates. - Controls: Settings., Objects., + Add Custom Object., Mark Primary Field as Unique., Create Custom Object. Full procedure: 1. Go to Settings. 2. Click on Objects. 3. Click on + Add Custom Object. 4. Define the Custom Object Name and Primary Display Field. 5. Check Mark Primary Field as Unique. 6. Click Create Custom Object. 7. This ensures the primary field (for example, Case No. or VIN Number) cannot have duplicates. <- this image --- ## **How to Modify Unique Fields**   **Note:** Once downgraded from unique to non-unique, it cannot be made unique again. 1. Go to **Settings** > **Custom** **Fields**. 2. **Find** or **Search** the Unique Custom Field. 3. **Select** the Field. 4. Click on **Bulk** **Actions** > **Edit**. 5. **Deselect** Mark Field as Unique option. ![How to Modify Unique Fields (image 7 of 7)](https://jumpshare.com/share/HsyIwTp1umfOumoWWyB8+/GIF+Recording+2025-10-15+at+9.37.09+PM.gif) **How to Modify Unique Fields (image 7 of 7)** This animation appears in the "How to Modify Unique Fields" section of "Custom Objects - Unique Fields Support". The text alongside this image reads: Go to Settings > Custom Fields. Find or Search the Unique Custom Field. Select the Field. Click on Bulk Actions > Edit. Deselect Mark Field as Unique option. The navigation path used here is Settings > Custom Fields. Immediately after, the guide continues: Scenario Action Result Two records have the same value in a Primary field User saves Error: “A record with the same value already exists.” Two records with the same value in a non-primary unique field User saves Partial success –…. - Path: Settings > Custom Fields - Where to go: Go to Settings > Custom Fields. Find or Search the Unique Custom Field. Select the Field. Click on Bulk Actions > Edit. Deselect Mark Field as Unique option. - Controls: Settings, Custom, Fields, Find, Search, Select, Bulk, Actions, Edit, Deselect - Next: Scenario Action Result Two records have the same value in a Primary field User saves Error: “A record with the same value already exists.” Two records with the same value in a non-primary unique field User saves Partial success – duplicate rows skipped with warnings Field marked as unique, then user attempts deletion Delete Warning – field cannot be deleted Unique field downgraded to non-unique User saves Allowed, but irreversible API used to update with duplicate value Update call API returns validation error Full procedure: 1. Go to Settings > Custom Fields. 2. Find or Search the Unique Custom Field. 3. Select the Field. 4. Click on Bulk Actions > Edit. 5. Deselect Mark Field as Unique option. --- ## **Example Scenarios** | Scenario | Action | Result | | --- | --- | --- | | Two records have the same value in a Primary field | User saves | Error: “A record with the same value already exists.” | | Two records with the same value in a non-primary unique field | User saves | Partial success – duplicate rows skipped with warnings | | Field marked as unique, then user attempts deletion | Delete | Warning – field cannot be deleted | | Unique field downgraded to non-unique | User saves | Allowed, but irreversible | | API used to update with duplicate value | Update call | API returns validation error | --- ## **Best Practices** - Use unique fields for identifiers or keys (for example, Patient ID, Case No., Employee Code). - Avoid marking frequently updated text fields as unique. - Before imports, deduplicate data externally to prevent import warnings or skips. - Plan field uniqueness early — re-enabling unique later is not supported. --- ## **Frequently Asked Questions** **Q: Does uniqueness apply account-wide?** Yes. Uniqueness is enforced globally across the sub-account. **Q: Is the check applied on updates as well as creates?** Yes. Create and update actions are both blocked if the unique value already exists. **Q: What error do users see on a duplicate?** You’ll see a message like: “A record with the same value for already exists.” **Q: Where is uniqueness enforced?** Across all entry points: manual record creation, workflows/automations, and forms. **Q: Can I mark a dropdown or email field as unique?** Only Single Line, Multi Line, Number, and Phone fields are supported in this release. **Q: What happens during a CSV import if duplicates exist?** The import finishes, but rows with duplicate unique-field values fail.  **Q: Do uniqueness checks slow down API bulk inserts?** No. The validation is optimized at the database layer, so performance impact is negligible even for large batches. **Q: Can two sub-accounts have the same value in a unique field?** Yes. Uniqueness is enforced per sub-account, not across the entire agency. --- ## **Related Articles** - [Getting Started with Custom Objects](https://docs.ghlcustomercare.com/docs/custom-objects/getting-started-with-custom-objects/getting-started-with-custom-objects) - [Creating and Editing Custom Objects](https://docs.ghlcustomercare.com/docs/custom-objects/getting-started-with-custom-objects/creating-and-editing-custom-objects)  - [Creating and Updating Custom Object Records](https://docs.ghlcustomercare.com/docs/custom-objects/getting-started-with-custom-objects/creating-and-updating-custom-object-records)  - [Using Custom Objects in Workflow Actions and Triggers](https://docs.ghlcustomercare.com/docs/custom-objects/getting-started-with-custom-objects/using-custom-objects-in-workflow-actions-and-triggers) --- Documentation for GHL Customer Care. Support: support@ghlcustomercare.com