Skip to main content

How to Define Fields as Unique Identifiers (UID) in Audience

Learn how to set up fields as unique to ensure your Audience database is kept clean and accurate.

Casey Lin avatar
Written by Casey Lin
Updated this week

zkipster Audience is a powerful tool that allows you to store and manage your contacts data seamlessly, using data that is exclusive to each individual (unique identifiers) to ensure contact profiles are unique and updated accurately to avoid important data being overwritten or duplicates being created.


🔍 What Is a Unique Identifier?

A Unique Identifier is a type of value that must be unique for each contact in your Audience contact list. The UID field is used by the system whenever data is being added to Audience to crosscheck with existing contact profiles and prevent you from creating duplicates and compromising the accuracy of your Audience database.

The best Unique Identifier for you to set up will depend on what data you already have from your contacts and, amongst that, what piece of data is unique to each individual contact.

The most common fields set as unique identifiers are:

  • Primary Email Address

  • External ID

  • Custom Fields*

*Please note: Not all custom fields or default fields are available to be set as UIDs. Please refer to this section below to learn what fields can be set as a unique identifier.


🛡️ Why Unique Identifier Fields (UID) Matter

Using UIDs helps you:

  • Prevent duplicate contact profiles during manual or automated imports of contact data.

  • Maintain data consistency when syncing between zkipster Events and Audience.

For example, if John Doe is already a contact in your Audience account with the primary email john.doe@zkipsterevents.com and you set up the 'Primary Email' field as the UID, when someone else imports a spreadsheet that includes the same email address on that field, the system will detect the match, prevent a new duplicate contact from being created and trigger an Error:

To learn more about how to resolve errors when importing data to Audience, see the article: **How to Resolve Data Conflicts and Errors in Audience** [Link to be added]


⚙️ How to Configure Fields as Unique Identifiers in Audience

  1. Go to the Configuration Menu


    Navigate to the left-hand side menu and open the 'Configuration' page. Under the Unique Fields section, you can manage your UID.

  2. Default Unique Field - zkipster Contact ID

    Every Audience contact automatically gets a zkipster Contact ID - this is always unique to each profile and cannot be changed.

  3. Choose Up to 3 Additional Unique Fields

    On top of the 'Contact ID' field, you can define up to three additional UIDs by clicking on the 'Add Option +' button and using the dropdown menu to select the field:


    Please Note: You don’t need to add all three additional UIDs - only define those that make sense for your data.


    If you need to remove a UID, simply click on the 'minus' icon on the right side of the field:

  4. Validate the Field

    If the field you select already has duplicate values in your existing Audience contact list, a red exclamation mark will appear.

    If the select field values are all unique across your existing contact database, you’ll see a green check mark, and you can proceed.

  5. Click on 'Save Changes'.


🔁 Using Unique Identifiers with zkipster Events Integration Enabled

When using the integration between zkipster Events and zkipster Audience, the UID field is what zkipster uses to identify if guest data being imported from Events should result in the creation of a new contact profile in Audience or if it should update an existing contact.

For example, if the 'Email' is the field I defined as the UID on both Events and Audience, when I select to add guests from Events as contacts in Audience, the system will crosscheck the data from the 'Email' field being imported from Events with the emails already present in Audience. If a contact is located with the same email address on the 'Email' field as a guest being imported, instead of a new contact being created, the system will update the existing contact with the same email address.

To define the UID that should be used when syncing data across Events x Audience:

1 - Open the 'Integration' page in Audience.

2 - From the top section, select the UID field in Events and match with its equivalent field in Audience.

Example:

If “Email (Primary)” is the UID:


🧩 Which Fields Can Be Unique Identifiers (and Which Cannot)

Not all contact fields in Audience can be used as UIDs. Only fields that accept a single, plain value are eligible. These include:

  • Standard text fields such as Email (Primary), Phone Number, or External ID.

  • Custom fields formatted to hold a single text value.

However, fields that support multiple inputs or alternative formats are not allowed. These include:

  • Multi-value or multi-choice fields (e.g., labels or tags)

  • Custom fields with formats: Color, Single Choice, Multiple Choice

  • Color fields

  • Alternative contact fields

  • Address fields

  • Socials fields

  • Relationships fields

These types of fields are excluded because they do not guarantee a single, unique value per contact—something that’s essential for effective deduplication and integration.


✅ Best Practices

  • Use stable, unique values—emails or CRM IDs are often ideal.

  • Avoid fields that can potentially have shared values in the future, like Last Name or Organization.

  • Double-check for potential contact duplicates before setting a field as unique.


By properly configuring unique fields, you ensure smoother imports, cleaner data, and more efficient guest management across all zkipster tools. Need further help? Please reach out to our Support team via support@zkipster.com or refer to our Help Center.

Did this answer your question?