User properties

In addition to names and email addresses—which are automatically populated—DX supports several core user properties that enhance personalization, reporting, and integration across the platform.

Property Purpose
startdate Used to measure ramp-up time and assign users to tenure bands. This property is required for Onboarding.
githubusername Associates GitHub activity with DX user records. This property is required for GitHub-based reports and PlatformX surveys.
githubusername2 An additional field for instances where more than one GitHub instance exists.
gitlabusername Associates GitLab activity with DX user records. This property is required for GitLab-based reports and PlatformX surveys.
excludefromsnapshots If set to TRUE, excludes the user from Snapshots.
ailightadoptiondate Date on which user became a light AI adopter.
aimoderateadoptiondate Date on which user became a moderate AI adopter.
aiheavyadoptiondate Date on which user became a heavy AI adopter.
ssoemail Alternate email used to authenticate through SAML SSO.

Setting properties

For setting GitHub usernames, please see How does DX link user identities across systems?. For all other properties, DX offers five methods for setting properties as described below:

Method Description
CSV upload Upload CSVs by browsing to the User CSVs admin area in DX.
Web API Use the users.update Web API method to set properties.
Okta sync Enable Okta directory sync to sync properties automatically.
Profile editor DX provides a profile editor to use in onboarding checklists.
Workday RaaS User properties can be included in Workday RaaS reports.