Custom fields allow you to add extra information about a contact to your contact database when you upload a CSV. With custom fields, you can create custom segments from your individual contacts or from your contact database that dynamically update your content with the values for the individual contact receiving the email. Your custom fields are completely customizable to the use cases and user information that you need.

You can create up to 120 custom fields.

Create a Custom Field

Before you can create a custom field in the SendGrid app, you need to format and upload a CSV to your contacts database.

To add custom a field:

  1. Once you have successfully uploaded a CSV containing custom fields, navigate to the custom fields page.
  2. Click Create New Field.
  3. Add a Field Name and Field Type.
  4. Click Save.

The field name should be created using only alphanumeric characters (A-Z and 0-9) and underscores “_”. The field type can be date, text, or number fields. The field type is important for creating segments from your contact database.

You can query your list in different ways, based on the data type:

  • Date - allows you to select contacts before, after, or on a specific date. Example: 1/1/2014
  • Text - allows you to select contacts who match the specific text. Example: Pet field that says “Dog”
  • Number - allows you to do things like “greater than,” “less than,” or “equals.” Both decimal and integer values are accepted. Example: The age of your recipient: 27

Text custom fields are limited to a size of 32,766 bytes.

Reserved Fields

Your account comes preloaded with reserved fields that cannot be removed. The following field names are all reserved: id, first_name, last_name, email, lists, created_at, updated_at, last_emailed, last_clicked, last_opened. Except first_name, last_name, and email, these fields are auto-populated by SendGrid.

Deleting a Custom Field

To delete a custom field:

  1. Navigate to Marketing Campaigns and select Custom Fields.
  2. Locate the field you wish to remove.
  3. Hover over the action menu to the right of the field name entry.
  4. Select the delete icon.
  5. Click Confirm.

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 is used in a segment. This deletion process may take several minutes–you continue to see the custom field on this page until the process has completed.

Additional Resources