Custom User Attributes

This article describes how Custom User Attributes can be defined and used in Luma.

Overview

In addition to the standard user profile fields provided by system, users may require a few additional user specific fields. In Luma, a Tenant Administrator can define a list of Custom User Attributes that can hold user information specific to your organisation like Location, AD IDs, Designation etc. These values can be used for User authorisation, user data sync or can be referred while building a skill in branching or as information to be passed through Integrations outbound payload.

Luma allows a maximum of 15 Custom User Attributes for a tenant.

Value for a Custom User Attribute can be populated through Bulk data upload or data sync through APIs. Alternatively, these can also be set during session initialization through a configured chat channel or in a skill just like any other conversation parameter. Scope of these attributes is global i.e. the value is retained unless overwritten.

Similar to Local and Global attributes in Luma, these attributes can also be used in Skills and Operations. These can be referred as @{user.<custom attribute identifier>}

To view the list of Custom User Attributes defined for your Tenant, Navigate to Tenant → User Management → Custom User Attributes tab. As an Administrator, you can create a maximum of 15 attributes for your Tenant.

Create a Custom User Attribute

Follow the below steps to create a Custom User attribute for your Tenant:

1. On Custom User Attribute tab, click on Create Custom User Attribute.

2. On the details screen, add attribute Name.

3. Identifier will be auto generated by the system based on the name. You may edit the identifier if required.

4. Select Data type based on the type of value the attribute will hold.

5. Once all the mandatory details are filled in, click on Create to create the attribute.

Search and View a Custom User Attribute

Custom User Attribute List can be filtered using Attribute Name or Identifier. Follow the below steps to search for an attribute in the list:

1. On Custom User Attribute List, type the text in Search field and press Enter.
   

   

2. The list is now filtered as per the search criteria.

3. Select the required attribute to view the details.

Edit Custom User Attribute

To edit an existing Custom User attribute, do the following:

1. On Custom User Attribute List, select the required attribute.

2. On details screen, click on Edit.

3. Only the Attribute Name field is now editable. Update the field as required.

4. Click Save to save the changes.

Using a Custom User Attribute

Custom User Attributes defined for your tenant, can be used throughout Luma to display user specific information. When used in a Skill or in Operations as outbound payload, these can be referred as @{user.<custom attribute identifier>}.

For example:

Using Custom User Attribute in Information Message in a Skill:

Using Custom User Attribute in Operation: