Home/HighLevel/Features/Custom Objects/How to use unique fields in HighLevel custom objects

CRM and Pipelines

How to use unique fields in HighLevel custom objects

In short

Unique Fields is a setting for custom object fields that forces every value to be distinct across all records in a subaccount. When a field is marked unique, HighLevel blocks any create or update that would duplicate an existing value, helping keep data clean and reliable.

AreaCustom Objects · Managing Custom Object Records
Used forReal estate team, Medical clinic, IT services firm
Setup steps18 steps in 3 tasks
Last updatedNovember 17, 2026

01Who this is for

  • Founders building a product catalog who need each SKU or serial number to be distinct.
  • Small business owners managing client records who must guarantee that ID numbers never repeat.

02Unique fields, explained

The feature lives in the Settings area of the platform under Custom Fields and Objects. When you enable the unique option on a field, the system validates every new or edited record and rejects duplicate entries. The check runs for all entry points, including the UI, forms, workflows, imports and API calls.

Uniqueness applies only within the current subaccount, so other subaccounts can reuse the same values. The setting can be applied only while the field is being created, and once a unique field is downgraded it cannot be re enabled. The platform supports this behavior for Single Line Text, Multi Line Text, Number and Phone field types.

03How businesses use unique fields

  • Real estate team. Create a custom object for property listings, mark the MLS number as the primary unique field, and prevent agents from entering duplicate listings. The unique setting stops duplicate entries during manual entry, imports and automated workflows.
  • Medical clinic. Define a custom object for patient records, set the Patient ID field as unique, and ensure that each new patient registration is rejected if the ID already exists. This protects against accidental reuse of identifiers across the clinic’s subaccount.
  • IT services firm. Build a custom object for hardware assets, mark the asset serial number as unique, and rely on the platform to block duplicate serial numbers when assets are added via forms or API calls.

04The numbers and rules that matter

  • Limit of 10 unique fields per object (applies across the subaccount).
  • Supported field types: Single Line Text, Multi Line Text, Number, Phone.

05How to set up and use unique fields in HighLevel

Mark a field as unique while creating a new custom field

  1. Open Settings.
  2. Select Custom Fields.
  3. Click the + Add Field button.
  4. Choose a supported field type such as Single Line Text, Multi Line Text, Number, or Phone.
  5. Enter the field name, assign it to the desired object and group.
  6. Check the box labeled Mark Field as Unique.
  7. Press Save to finish.

Mark a primary field as unique while creating a custom object

  1. Open Settings.
  2. Select Objects.
  3. Click the + Add Custom Object button.
  4. Enter the Custom Object Name and choose a Primary Display Field.
  5. Check the option Mark Primary Field as Unique.
  6. Click Create Custom Object to complete the setup.

Downgrade a unique field to non unique

  1. Navigate to Settings > Custom Fields.
  2. Locate the field that is currently marked as unique.
  3. Select the field to open its details.
  4. Choose Bulk Actions and then Edit.
  5. Uncheck the Mark Field as Unique option and save.

06What it looks like in HighLevel

07Settings that matter

  • Mark Field as Unique. Controls whether the chosen custom object field must contain a value that does not already exist in any other record within the same subaccount.
  • Mark Primary Field as Unique. Ensures the primary display field of a custom object cannot duplicate values across all records in the subaccount.

08Things to know before you rely on it

  • A maximum of ten unique fields can be defined per custom object across the subaccount.
  • Only Single Line Text, Multi Line Text, Number, and Phone field types support uniqueness in this release.
  • Once a unique field is downgraded to non unique, it cannot be re enabled; the action is irreversible.
  • Uniqueness checks are applied to both record creation and updates, and they operate across UI, forms, workflows, imports and API calls.

09How it connects to the rest of HighLevel

Michael's take

Michael Reimer
Michael ReimerFounder of CRM Pros, HighLevel Commander and Certified Admin

Unique fields let you lock down things like invoice numbers or employee IDs without building extra validation logic. It stops you from accidentally reusing a key. Don’t mark a field that you edit constantly as unique. It will lock people out of normal updates.

Get More InformationOpens on HighLevelPublished November 2, 2026 · Updated November 17, 2026

Common questions

Common questions about unique fields.

Does uniqueness apply across the entire agency?

Uniqueness is enforced only within the current subaccount, not across other subaccounts.

Are duplicate checks performed on record updates?

Yes. Both create and update actions are blocked if the unique field value already exists.

What error appears when a duplicate value is entered?

The system shows a message such as “A record with the same value for <fieldName> already exists.”

Can I make a field unique after it has already been created?

No. The unique option can only be set during field creation; it cannot be enabled later.

Which field types can be marked as unique?

Only Single Line Text, Multi Line Text, Number and Phone fields are supported for uniqueness.

Next step

Pick the features that matter. Then get the plan that unlocks them.

Explore the features you want, start with the five at the top, and upgrade through my link when you are ready. The bonuses and the team come with it.

The features directory explains every HighLevel feature in plain English. Browse it to see what the platform can do.

Back to the FeaturesSee the full details
⌃

Site preview

Explore the next page

This destination is reserved in the page inventory and is not built yet.