--- title: "How to Configure Identity Attributes" slug: "identity-attributes" description: "Clarity offers a configurable method for defining the preferred attributes for Identity records." tags: ["Attributes", "Identity", "Settings"] updated: 2026-06-16T19:18:24Z published: 2026-06-16T19:18:24Z canonical: "help.claritysecurity.com/identity-attributes" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.claritysecurity.com/llms.txt > Use this file to discover all available pages before exploring further. # Identity Attributes Clarity offers a configurable method for defining the preferred attributes for Identity records. --- ## Identity Attributes in Clarity An identity attribute is a piece of information (such as a name, email address, department, job title, etc.) used to describe a service user. There are many other attributes collected by Clarity (and displayed in the Attributes tab on an Identity), however the attributes described below are used to help build the Clarity Identity object and interact directly with other functions of the Clarity platform. **Two categories of Identity Attributes**: - [Standard Attributes](/v1/docs/configure-identity-attributes#standard-attributes) - [Custom Attributes](/v1/docs/configure-identity-attributes#custom-attributes) ### Attributes source ranking Each attribute defined on this page can be sourced from your various Downstream Applications, which support attribute matching, common examples include your HR platform, directory services (like MSAD, Azure AD, Okta), Database connections, etc. After connecting your applications, you will want to set your Attribute Precedence. ![First Name - Attribute Precedence](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/First%20Name%20-%20Attribute%20Precedence.png?sv=2026-02-06&spr=https&st=2026-10-31T19%3A10%3A34Z&se=2026-10-31T20%3A10%3A34Z&sr=c&sp=r&sig=bRh%2BTYXsLuPgo3J1AnuH7CDYZseCabKH64KNb8Cacgo%3D) --- ## Standard attributes These attributes are built into Clarity and help make up the key identifying values of a Clarity Identity. - First Name - Last Name - Active - Email - Supervisor --- ## Custom attributes Custom Attributes are user-configurable fields that can be used to further describe an identity and enable additional levels of granularity for Role Based Access Control. These fields are used to populate the dropdown menu for Organizational Units. Common examples of custom attributes include: - Job Title - Department - Cost Center - Division --- ## How do I configure the identity attributes? ### Step 1: Connect to one or more applications that support attribute mapping. For instructions on how to connect to your downstream applications and which apps support attribute mapping, see the app marketplace section of the documentation here: [Application Marketplace](https://claritysecurity.com/platform/supported-integrations/). ### Step 2: Go to Settings > Identity Attributes ![image.png](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image%28412%29.png?sv=2026-02-06&spr=https&st=2026-10-31T19%3A10%3A34Z&se=2026-10-31T20%3A10%3A34Z&sr=c&sp=r&sig=bRh%2BTYXsLuPgo3J1AnuH7CDYZseCabKH64KNb8Cacgo%3D) ### Step 3: Configure standard attributes for your identities. Note The attributes detected from the downstream applications you've connected to will automatically be added to the drop-down menus. To edit an existing attribute, click the pencil icon on the right side of the screen. Click "Add Another Source" to see the attributes available to be mapped to the standard attributes. The box is text enabled, so you can search for specific attributes without scrolling. ![Standard Attributes - Add Another Source](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image%28134%29.png?sv=2026-02-06&spr=https&st=2026-10-31T19%3A10%3A34Z&se=2026-10-31T20%3A10%3A34Z&sr=c&sp=r&sig=bRh%2BTYXsLuPgo3J1AnuH7CDYZseCabKH64KNb8Cacgo%3D) Standard attributes will have a type already assigned which is not editable. Custom attributes will prompt you for the attribute type. For most attributes that contain arbitrary data, this should be set to "String". Some attributes will use preset lists of options, such as country codes. If the custom attribute you are setting up should be selected from a list of countries, select "Microsoft Countries". We will continue to expand the list of preset values over time to fit new use-cases. ![image.png](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image%28413%29.png?sv=2026-02-06&spr=https&st=2026-10-31T19%3A10%3A34Z&se=2026-10-31T20%3A10%3A34Z&sr=c&sp=r&sig=bRh%2BTYXsLuPgo3J1AnuH7CDYZseCabKH64KNb8Cacgo%3D) ### Step 4: Refresh Identity Attributes Once you have completed your changes or additions to the Standard or Custom Attributes precedence rankings, be sure to hit the **Refresh Identity Attributes** button to trigger Clarity to reflect your changes in the UI. ![Refresh Identity Attributes](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/Refresh%20Identity%20Attributes%282%29.png?sv=2026-02-06&spr=https&st=2026-10-31T19%3A10%3A34Z&se=2026-10-31T20%3A10%3A34Z&sr=c&sp=r&sig=bRh%2BTYXsLuPgo3J1AnuH7CDYZseCabKH64KNb8Cacgo%3D) --- ## Need Help? If you have any problems, contact your customer success team. You can also get in touch with our general support [via email](mailto:support@claritysecurity.io), open a [support ticket](https://support.claritysecurity.com/home). Our general support team is available Monday - Friday from 8:00 AM - 6:30 PM CST. An identity is a single entity's (employee, contractor, service account) grouping of service users, attributes, and assigned entitlements. A Downstream Application is any application that supplies Clarity with service users, entitlements, and attributes. Role Based Access Control is an approach to managing access by provisioning pre-approved access based on an Identity's function within an organization. Organizational Units are a top down hierarchical structure used to generate Roles in Clarity.