Custom Properties let you store additional contact information beyond default fields like email address, name, and phone number. Use them to save brand-specific data such as product preferences, preferred newsletter type, and more. This data helps you personalize campaigns and segment your audience.
This article explains how to collect, locate, and use custom properties in Omnisend.
Collecting Custom Properties
You can add custom properties to contact profiles using the following methods:
Learn how each method works below.
Collecting Custom Properties with Signup Forms
To add a custom property to a signup form, go to the Forms tab and open or create a form. Then, drag and drop a Dropdown, Input, or Date field into the form. In the field settings, select Custom property under the Map to profile field option.
You can pick an existing property or create a new one by typing the name → Create new.
If you used a Dropdown item, you can add custom property values under Manage your choices.
Collecting Custom Properties via Subscriber Preference Center
The Subscriber Preference Center allows your contacts to update their preferences, including custom properties such as product interests, communication frequency, or preferred topics.
To add custom properties to the Preference Center, go to Store settings → Preference management → Add new field → select Custom property.
Adding Custom Properties to the Customer Profile
To add a custom property to a single contact, go to Audience → Contacts → Click the contact's name to open the contact profile page → Click Edit.
In the Edit profile details tab, switch to the Custom tab and click Add property. From there, you can select an existing custom property or create a new one.
💡 A single contact can have an unlimited number of custom properties. Each custom property can hold different values per contact.
Adding Custom Properties with Contact Import
When importing contacts from a CSV file, you can create and populate custom properties by mapping your file columns to custom properties.
During the Map properties step, click the dropdown next to the column you want to map → Scroll down and select Custom Property → Start typing the name of your custom property. If it doesn’t exist, you’ll see a Create New option appear.
Collecting Custom Properties through API
You can use the Omnisend API to send custom property data from third-party apps, integrations, or your own custom events. You can create, update, and sync custom properties automatically using API.
Note: Custom property names must use only Latin characters, numbers, and underscores, with a maximum of 128 characters. String values can be up to 2,048 characters.
Locating Custom Properties
To view custom properties, open a contact profile and find the Custom Properties section in the left-hand menu.
Using Custom Properties
You can use custom properties to personalize messages and segment your audience.
Personalize Campaigns - Custom properties can be used in emails, SMS, and push notifications to deliver tailored content. Learn more about Personalization in Omnisend.
Segment Your Audience - Build segments based on custom properties and use them to:
Send segment-based campaigns;
Create segment-based automation or set conditional splits based on segments;
Sync with Facebook Custom Audiences;
Sync with Google Ads Customer Match;
Exporting Custom Properties
When you export your contacts, each custom property generates a stand-alone row with different values assigned to your contacts.
💬 Check the instructions for exporting your contacts to the file.
FAQ
I created a custom property, but it doesn't appear in my segment filters. Why?
Custom properties only appear in segment filters after at least one contact has been assigned that property. Go to Audience → Segments → Create Segment → Create from Scratch, then scroll all the way down to the Custom Properties section at the bottom of the filter dropdown. If it's still not there, add the property to at least one contact or wait for a form submission/import to populate it.
I'm trying to create a custom property during import, but I don't see the "Create New" option. What am I doing wrong?
The "Create New" option only appears when you start typing a custom property name that doesn't already exist. In the Map properties step, click the dropdown for the column you want to map, then start typing a new name (e.g., "loyalty_points"). If no existing property matches, you'll see Create New appear. Click it to create the property.
Can I Rename or Delete a Custom Property?
Custom properties cannot be renamed once created. However, you can delete a custom property from an individual contact’s profile.
If the property is collected through a signup form, you can either remove the related field (e.g., dropdown) or update its label. This ensures that new submissions are assigned to the correct property moving forward.
If you didn't find the answer to your question, reach out to our Support Team via in-app chat or at [email protected].









