🏷️User Attributes

User attributes allow for personalized experiences for Whaly users. These attributes are defined by Whaly administrators and can be applied to individual users.

User attributes can be referenced throughout Whaly to provide a custom experience for each user. Whaly provides several default user attributes including:

• ID

• Email

Viewing user attributes

To access your user attributes, navigate to the Access Admin > User Attribute section of the Setting menu and select the User Attributes page.

Here, you will find a table that displays the technical name, label, and type of each user attribute. The table also includes buttons for performing actions related to the user attribute.

Creating user attributes

To define a user attribute, click the Create new Attribute button at the upper right of the screen. Each user attribute has the following settings:

• Label: The user-friendly name of the attribute.

• Technical Name: The technical name of the user attribute, that will be used in the API or in CSV users imports.

• Data Type: This setting is used to check that valid values are assigned to users for this user attribute. The data type of the user attribute can be one of the following:

  • String: Select this option to create a user attribute that exactly matches one or multiple string value, such as a username, tenant ID, ...

  • Number: Select this option to specify a single number, such as employee number.

  • Date: Select this option to specify a single date or time, such as user's birth date or a max lookback date.

  • Boolean: Select this option to set this attribute to be either set as True or False.

• Allow multiple values: Select this checkbox to allow users to have multiple values for the attribute. It can be useful if you want some manager to have access to multiple Sales region for example.

• Allow only specific values: Select this checkbox to pass the allowlist of authrorized values that can be given for this attribute to user.

• Set a default value: Select this checkbox to set a default value in case a value is not assigned to a user.

Assigning values to individual users

After defining a user attribute, you can assign a value for it to an individual user:

1. Go to the Settings > Access Admin > Access Management page.

2. Choose the user to assign a value and click on "Edit User"

3. In the Attributes section, enter the new value in the proper field.

4. Click Save.

Where can user attributes be used?

Reports Filters

Filters on reports can be set to a user attribute to customize the query based on the user who is running it.

For example, you could configure a user attributes named "salesforce_username" and customize it for every Whaly user by entering their Salesforce username as its value. By setting a filter on a dashboard using the "salesforce_username" user attribute, each user would be able to view the dashboard with data filtered according to their particular Salesforce username.