HomeGuidesAPI Reference
Submit Documentation FeedbackJoin Developer CommunityLog In

Objects & Fields

This topic describes fields for storing custom metadata in Optimizely Data Platform (ODP).


Fields allow storing custom metadata on any ODP Object. Fields can store a variety of data:




Any printable UTF-8 character, including space. Text is limited to 1024 characters.


A number represented in standard decimal format (Example: 0, 3.14159, -2.3, -0.112)

Date & Time

Must be formatted as ISO 8601 format or UNIX epoch (seconds since January 1, 1970). Examples: 1435708800, 2015-07-01T00:00:00-00:00, 2015-07-01T12:30:00-07:00

Note: If time and time zone are not provided, the time is assumed to be 12am UTC.


Must be one of 0, 1, true, or false

Create Custom Fields in UI

  1. Go to Account Settings -> Objects & Fields and select Create New Field.
  2. Select the object that should own the field (for example, Events or Customers).
  3. Select the field name and field display name.
    1. Field Name: The name used for API/SDK/CSV uploads and within Liquid templates.
    2. Field Display Name: The user-friendly name used in reporting, segmentation and campaigns.

Create Custom Fields via API


Create Custom Objects and/or Identifiers



Custom Objects & Identifiers are only available for creation by app developers and ODP Customer Success/Support. To learn more, contact your CSM or our support team.

Did this page help you?