Fields Setup

Table of Contents


The Fields Setup screen is where you can setup all your custom fields (aka data points) you'd like to associate with each contact in a given List. For example, First Name, Last Name, Gender, City, State, etc.

  • The Ongage system comes with one mandatory field "email" and several sample custom fields. .
  • Out-of-the-box, your Ongage, account contains several additional list fields besides the email, provided as a sample, which you can choose to keep or remove based on your needs.
  • The only field that cannot be removed or renamed is the "email" field.
  • The max number of list fields allowed in your account, depends on the Ongage package you purchased (see our pricing page for details). Speak to your account manager if you need more list fields.

How to add a field to a list 

  1. On the main menu bar under the List menu item click on List Settings:

  2. Select the Fields Setup tab:

  3. Click  Create New Field button to start creating a new field.
  4. Enter Field Name and Title
    Select the type of field you'd like to add (i.e., String, Email, Date, Numeric, see more information about this in the following section).

    Note: You can determine if that field should be mandatory or not when adding a contact to this list. As noted above, by default, only the email field is mandatory, and for most use-cases there's no need to add additional mandatory fields, though each business can set this according to their own requirements.

  5. Click Create to complete.

         Note: If you want to add this field to all the lists, use the Create in all lists button.

What are the different field types

There are currently 4 different types of fields available in Ongage:

  • Email – data has to be entered in an Email address format.
  • String – any type of alphanumeric data may be entered including special characters and spaces.
  • Date – data has to be entered in a Date format. You also need to choose the format you would like to use
  • Numeric – only numeric (numbers) data may be entered. (See important info right below)

Note: Ongage does not have a Boolean field type, but that can easily be simulated using a String (Y/N) or Numeric (1/0) field. In addition in our Segment module for each custom field there an "is empty" and "is not empty" criterion. 

See our List FAQ for recommendations on which field type should you use for ZIP codes, Phone Numbers, etc.

What is the max size of a string field

In Ongage there are 3 types of String fields:

  • String: 255 bytes. Typically used for personal names, city, state, etc.
  • Long String: 2K bytes. Typically used for storing multiple values, like areas of interests, e.g.: "news;sports;entertainment:etc.", in which case in your segments you would use the contains criterion instead of equals.
  • Huge String: 65K bytes. (warning) Note: this string type cannot be used in a Segment criteria. The other 2 above can!

(info) Note: Limitations may apply to the number of Long Strings and Huge Strings you can have in a list/account based on your Ongage package.

See the List section in our How To User Guide for more detailed information about Ongage Lists.