Add custom attributes to a default Okta group profile

Add custom attributes to a default Okta group profile to define attributes that aren't available in the base attributes.

If you're subscribed to Okta Identity Governance and deleted the attributes provided by the User-friendly group name and description feature, see Add custom attributes to the default group profile instead.

  1. In the Admin Console, go to DirectoryProfile Editor.
  2. Click the Groups tab.
  3. Click Okta group.
  4. Click Add attribute.
  5. Complete these fields:
    • Data type: Select one of these data types:
      • string: A chain of zero or more Unicode characters (which may include letters, digits, and punctuation marks)
      • number: A floating-point decimal in Java's 64-bit Double format. See Platform Specification.
      • boolean: Stores true, false, or null data values
      • integer: Whole numbers in 64-bit Java's Long format
      • string array: A sequential collection of strings
      • number array: A sequential collection of numbers
      • integer array: A sequential collection of integers
    • Display name: Enter a descriptive name to display for the attribute in the Admin Console
    • Variable name: Enter an attribute name that can be referenced in mappings
    • Description: Enter a description for the attribute
    • Group Priority: This field appears when any type of array is selected as the data type. Select an option to determine how groups affect a user's attributes. See Prioritize application groups and Group prioritization use case.
      • Use Group Priority: When a user belongs to more than one group, the user attribute value comes from the group with the highest group priority.
      • Combine values across groups: When a user belongs to more than one group, the user attribute value is the combination of values from the groups.
  6. Optional. Complete the following fields:
    • Enum: Select Define enumerated list of values to define an enumerated list of values. Supports all data types except boolean.
      • Attribute members: Enter the Display name and Value for an attribute. For example, you might choose to display Small for the value 1.
      • Add Another: Optional. Click this to add another attribute member.
      • Restriction: Select Value must be unique for each group, if the value must be unique for each group.
      • Attribute length: Enter the minimum and maximum length of the Value field.
    • Attribute required: Select Attribute is required to make this attribute mandatory.
  7. Click Save.