Custom fields in Feature Experimentation

  • Updated
  • Optimizely Feature Experimentation
Custom fields are currently in beta. Contact your Customer Success Manager for information.

Custom fields let you add required or optional metadata to flags. These fields can go beyond standard properties like name, key, and description, giving you more control over how you organize and manage your experimentation workspace.

Custom fields let you

  • Capture domain-specific details such as pages, lines of code, JIRA link, categories, or so on.
  • Improve reporting and tracking across projects.
  • Organize experiments and flags for better visibility.

When you require or let collaborators enter these fields during flag creation or editing, you add structure and accountability to your experimentation workflow. This approach also scales easily as your experimentation program grows.

After you configure custom fields, you can

  • Filter flags by specific criteria.
  • Sort and group items for quick access.
  • Use metadata as organizational signals to improve discoverability.

Custom fields bring flexibility and clarity to your experimentation process, making it easier to manage your projects and align with modern project management practices.

Benefits of custom fields

Custom fields provide the following benefits for managing and scaling experimentation programs:

  • Organization and clarity – Categorize experiments and flags for easier management and improved discoverability through enhanced filtering.
  • Improved insights – Use custom fields in dashboards and reports for comprehensive impact analysis across various dimensions.
  • Scalability and efficiency – Provide structured tagging to reduce duplicate experiments and minimize configuration errors in large organizations.
  • Enhanced collaboration – Promote a unified approach to experimentation across teams and simplify experiment reviews with consistent metadata.

Create custom fields

  1. Go to Settings > Fields.

    Settings > Fields
  2. Click Create Custom Field.
  3. Enter a Name and add a Description (optional).
  4. Select the Make this field required checkbox to require input when someone creates a flag using the API or UI.

    The custom field is applied at the Flags level, as indicated by the Entities drop-down list. See Manage flags for information on how users configure the custom fields. 

  5. Select the Type of custom field.
    • Label – Users can choose from one or more values you provide. Select Allow multi-select to let users select multiple values.
    • Text – Users can enter any text value. You can set a Character Limit if needed. This is how many text characters users can enter for the field.
    • Numerical – Users can enter any number within a defined range. You can set the acceptable numeric range, specify decimal places, and choose to format numbers with a comma separator for thousands.
    • Link – Users can enter any link.
    • Boolean – Users select either true or false.
  6. Click Create Custom Field to save the field.

Edit custom fields

Go to Settings > Fields.

The Fields page lists all custom fields. Use the search bar to find fields by name or key, or filter results by Type or Status using the dropdown lists.

Click More (...) > Edit for the field you want to edit.

Make the necessary changes and click Save.

You can only edit the Name and Description of custom fields.

Archive custom fields

You can archive a custom field to remove it from the list of custom fields.

Optimizely Feature Experimentation retains your custom field data so you can unarchive it later.

  1. Go to Settings > Fields.
  2. Click More (...) for the field.
  3. Click Archive.

Unarchive custom fields

To unarchive a field, complete the following steps:

  1. Go to Settings > Fields.
  2. Select Archived for the Status.
  3. Click More (...) for the field.
  4. Click Unarchive

Custom fields on the Flags Dashboard

To display the custom fields you created, on the Custom Flags Dashboard complete the following steps:

  • Go to Flags.
  • Click Show/Hide Columns

  • Click the Column tab.
  • Select your custom fields.
  • Click Close or anywhere outside the Table Options section to save your selection.

Feature Experimentation displays the custom fields you select in a column.

See Update custom fields for information on setting custom field values. See Custom Flags Dashboard for information on what Feature Experimentation displays on the Flags Dashboard.