Custom user attributes

Custom user attributes in DX allow you to filter and break down reports by any dimension that matters to your organization.

For example, with an Employment Type attribute, you could ask: “Our deep work sentiment score dropped by 11 points—how does that differ between FTEs and contractors?”

DX customers commonly use attributes such as job level, primary programming language, work location, hardware used, tools used, and remote versus in-office.

Default attributes

DX provides two attributes out-of-the-box:

  • Tenure bands are generated based on user start dates, when available.
  • Coding activity level is collected during DX Snapshots through the question “Do you regularly write code as part of your job?”.

Setting attributes

We typically recommend updating attributes data—along with your team hierarchy data—before each DX Snapshot. You can set attributes using one of four methods:

  1. CSV upload
  2. API upload
  3. Responses to DX Snapshot questions
  4. Manual entry in the DX UI

CSV upload

The most common way to set custom attributes in by uploading User CSVs:

  1. Go to Admin > User CSVs as an admin user.
  2. Click the +Import button.
  3. Download a starter CSV:
    • If attributes already exist in DX, download your current user data.
    • If this is your first time uploading attributes (or starting fresh), download the CSV template for your source system:
  4. Add attributes by including columns that begin with attribute: such as attribute:Job title. Please note that column headers and values are case sensitive.
  5. To remove an attribute, leave the column out of your CSV and then delete the attribute from Custom attributes to fully remove existing data.
  6. Once you upload your CSV, DX will display a summary of the results, including any processing errors, and provide a CSV with error details.
  7. Fix errors by either updating your original file or editing the error CSV directly, then re-upload the corrected version.

API upload

You can programmatically update attributes using the DX Web API. Refer to the users.attributes.update method for details on request format and usage.

Snapshot questions

Certain types of attributes—like work preferences or tool usage—may not exist in systems like Workday. DX Snapshots allow you to gather this data directly from team members via custom attribute questions.

  1. Go to Snapshot settings.
  2. Add a custom attribute question—please note that you can include up to 3 custom attribute questions per snapshot.
  3. Define the attribute name.
    • This name will appear in report filters and breakdowns.
  4. Write the question and response options.
    • We recommend no more than 8 options.
    • There is a hard limit of 11 options.
  5. Use the preview to ensure the question and responses look correct.
  6. Save your changes and the question will be included in your next snapshot.
    • If you only want to collect this data once, remember to remove the question from future snapshots to avoid overwriting previous responses.

Examples

Attribute name Question Example Options
Work Environment Where do you primarily work from? Remote, Hybrid, In-office
Tool Usage Do you regularly use an AI code assistant? Yes, No, Planning to
Primary Language What is your primary programming language? JavaScript, Python, Java, Go, Ruby, Other
Machine Setup What kind of machine do you primarily use? Mac, Windows, Linux, Chromebook

DX UI

You can manually update custom attributes for individual users in the DX UI. While this method isn’t recommended for bulk updates, it’s helpful for managers who want to make changes for their own team members.

  1. Go to Teams and select the team that includes the user.
  2. In the Contributors table, find the user you’d like to update.
  3. Click the menu icon (⋮) next to their name and select Manage Attributes.
  4. Edit the relevant attribute values, then save your changes.