A simple list attribute allows you to store multiple values under a single attribute key. Each value in the list uses the same base type (for example, String or Phone).

Unlike single-value attributes, simple list attributes collect an array of values rather than a single input.

Capabilities

• Store multiple values for a single attribute (for example, multiple account IDs or phone numbers)
• Use supported base types:
  • String
  • Select
  • Phone
  • Date
  • Email
• Define minimum and maximum number of items
• Apply validation rules to each item in the list
• Make the attribute searchable (with indexing options)
• Display and edit values in:
  • Admin Console
  • Organization portal

Sample use cases

• Store multiple account identifiers associated with a customer.
• Maintain a list of values, such as reference IDs or tags.
• Allow administrators to manage multiple related values for a single attribute.

Configuration

To create a simple list attribute:

1. Select Create.
2. Choose Simple list.
3. Select the base type for list items (for example, String or Phone).
4. Configure the attribute.

General settings

Attribute path: storage path created for the attribute in the identity store.
Attribute name: name of the attribute used in the identity store and in hooks.

Attribute searchability: defines whether the attribute is indexed and searchable.

📘

Indexing limits and constraints are the same as for single-value attributes.

Enable attribute: controls whether the attribute is active.

Configuration tab

Attribute display name: label shown in the Admin Console and portals.

Self-service

Show attribute on My Account page: display the attribute in customer accounts.

Enable editing of attribute on My Account page: allow the modification of the values.

Admin Console

Show attribute in Admin Console: display the attribute in admin accounts.

Enable editing of attribute in Admin Console: allow administrators to modify values.

Organization Portal

Show attribute in Organization Portal: display the attribute in organization admin accounts.

Enable editing of attribute in Admin Console: allow organization admins to modify values.

List rules

Minimum items: minimum number of values required.

Maximum items: maximum number of values allowed. If the maximum number of items is reached, additional values cannot be added.

Item configuration tab

The Item configuration tab defines validation rules and input behavior for each item in the list. Available options depend on the selected underlying attribute type.

String list

• Minimum length: minimum number of characters.
• Maximum length: maximum number of characters.
• Regular expression: defines the allowed format.
• Error message: displayed when validation fails.

Select list

For select-based lists, you can define how values are presented and what options are available:

• Attribute render type:
  • Select: Displays a dropdown list.
  • Radio buttons: Displays all options as selectable buttons.
• Options:
  • Display name: Label shown to the customer.
  • Value: Stored value used internally.

Date list

For date-based lists, you can configure how dates are entered and validated:

• Render type:
  • Calendar picker: Allows selection from a date picker.
  • Separate inputs: Allows manual entry of month, day, and year.
• Date validation:
  • Start date: Defines the earliest allowed date.
  • End date: Defines the latest allowed date.

Phone and email lists

Phone and email list attributes do not include additional item configuration options.

Behavior and limitations

• Simple list attributes cannot be marked as required.
• Values are stored as an array under a single attribute key.
• Validation is applied per item, not to the list as a whole.
• Attribute searchability applies to the attribute, not individual list items.