This page is describing the functionality of the new Marketing Campaigns experience, if you're using legacy Marketing Campaigns, your workflow and screens may be a little different. For more information on the new Marketing Campaigns experience click here.
Custom Fields allow you to add extra information about a contact within your contact database when you upload a CSV. You can use custom fields to create dynamic segments or to personalize the subject lines or content of Marketing Campaigns emails you send. Your custom fields are completely customizable to the use cases and user information that you need.
You can create up to 120 custom fields.
To add a custom field:
The most common way to add custom fields is by including each custom field you’d like to add as a column in your CSV upload. If you’d like to add custom fields programmatically, see our API documentation
You can also add custom fields manually from the Custom Fields page.
The field name should be created using only alphanumeric characters (A-Z and 0-9) and underscores (_). Custom fields should only begin with letters A-Z or underscores (_). The field type can be
number fields. The field type is important for creating segments from your contact database. Note: If you have created a custom field that begins with a number, you will need to recreate it with a name that begins with letters A-Z or an underscore (_).
Custom fields that begin with a number will cause issues when sending with Marketing Campaigns.
You can create three different types of custom fields, based on the data type. Each data type will allow you to use different queries for segmentation:
Text custom fields are limited to 1,000 characters.
Your account comes preloaded with unremovable reserved fields. The following field names are all reserved:
|Field Name||Field Type|
SendGrid auto-populates 6 reserved fields:
Reserved fields are used by default to track useful metrics for your contacts.
To delete a custom field:
Deleting a custom field deletes all values for that field across your contact database. If you have any campaigns using the data in this field with a substitution tag, those values do NOT get replaced when you send the campaign. You cannot delete a custom field that a segment is using in legacy Marketing Campaigns. Currently, in the new Marketing Campaigns experience, you are able to delete custom fields that are currently in use, so be extra cautious when you delete any existing custom fields.
This deletion process may take several minutes, and you will continue to see the custom field on this page until the process completes
If a custom field value does not appear in the corresponding Substitution Tag, make sure that there is a value for that custom field associated with the contact in your contact database. If there is no value for a particular custom field, a space will be substituted instead.
If you do find that the custom field has an associated value on the contact’s profile page, check the spelling of the substitution tag in the content of your campaign.
Let us know how we’re doing! Please rate this page:
Please note, we cannot resolve account and login issues reported on GitHub. Contact support for account assistance.
Thanks for helping us improve our docs!