Custom Attribute Fields
Define Attributes for profiles, registration, and smart groups.
What This Is For
Attributes are custom data points on user profiles. Use them to store extra information, collect values at registration, and drive smart groups.
In the product the settings card is labeled Attributes (Configure → under Control User Access and Attributes). Docs still use Custom Attribute Fields as the page title.
You can create up to 20 attributes per workspace.
Who This Is For
Workspace administrators who design profile data and group rules. Often coordinated with whoever builds registration pages or IdP mappings.
Field Types
| Type | UI label | Behavior |
|---|---|---|
| Single choice | Single Select | Preset list; user picks one |
| Multiple choice | Multi Select | Preset list; user may pick several |
| Free text | Text | Any text up to 500 characters |
For select types you manage Field choices (add, import, sort, remove).
Accessibility
Each attribute has Attribute accessibility:
| Setting | Meaning |
|---|---|
| Required | Visible; the person must set a value |
| Optional | Visible; editable |
| Locked | Visible; not editable |
| Hidden | Not visible and not editable on the profile |
Registration pages can still collect or set values for attributes with different accessibility at signup—see Registration Pages.
Changing Attribute Type
Saving a change to an attribute’s type clears every user’s current value for that attribute.
When you change a Single Select or Multi Select attribute to a different type, Configure asks you to confirm before saving.
You cannot switch to Text while the attribute is referenced by a smart group rule. Plan type changes carefully—especially for attributes used in smart groups.
How to Add an Attribute
- Open Configure → Attributes.
- Choose Add Attribute.
- Enter Field name (and optional Field description).
- Set Attribute type and Attribute accessibility.
- For select types, add at least two choices (or import a list).
- Create the attribute.
Edit or delete attributes from the same list.
Map Directory Attributes Onto Skillhabit Attributes
When Entra, OpenID Connect, or SCIM should fill profile attributes, configure mappings under Configure → Connections → Attribute mappings—not on this Attributes list alone.
You map a source (OpenID Connect claim, Microsoft Entra property, or SCIM attribute) onto an existing Skillhabit attribute. For Single Select / Multi Select, choose whether unknown IdP values Match existing only or Create if missing.
Full steps and behavior: User Provisioning → Map Directory Attributes.
Release the field from Entra, Okta, Auth0, or SCIM first: Add Attributes to IdP Tokens and Profiles.
Related
- Registration Pages
- Smart Groups
- Users & Groups
- User Provisioning — directory sync and attribute mappings
- Add Attributes to IdP Tokens and Profiles
- Configure
