# User attributes management

{% hint style="info" %}
*<mark style="color:blue;">Path: SBO > Users > Attributes</mark>*
{% endhint %}

{% hint style="warning" %} <mark style="color:orange;">User attributes are similar to listing attributes.</mark>
{% endhint %}

* [Definition](#id-1.16.x-userattributesmanagement-definition)
* [Create user attributes](#id-1.16.x-userattributesmanagement-createuserattributes)
  * [Create a user attribute group](#id-1.16.x-userattributesmanagement-createauserattributegroup)
  * [Create a user attribute](#id-1.16.x-userattributesmanagement-createauserattribute)
* [Read user attributes](#id-1.16.x-userattributesmanagement-readuserattributes)
* [Update user attributes](#id-1.16.x-userattributesmanagement-updateuserattributes)
  * [User attribute groups](#id-1.16.x-userattributesmanagement-userattributegroups)
  * [User attributes](#id-1.16.x-userattributesmanagement-userattributes)
* [Delete user attributes](#id-1.16.x-userattributesmanagement-deleteuserattributes)
  * [User attribute group](#id-1.16.x-userattributesmanagement-userattributegroup)
  * [User attribute](#id-1.16.x-userattributesmanagement-userattribute)
* [Related resources](#id-1.16.x-userattributesmanagement-relatedresources)

## Definition <a href="#id-1.16.x-userattributesmanagement-definition" id="id-1.16.x-userattributesmanagement-definition"></a>

User attributes are additional information that is provided for each user.

Each user attribute can be linked to a user category and is thus dynamically displayed according to the user category selected for the users. Each attribute also offers a self-explanatory tooltip.

User attributes must be in user attribute groups. User attribute groups assemble user attributes by themes to facilitate their understanding and improve their visibility.

User attributes can be easily deleted even if linked to users due to their informative nature.

<mark style="color:orange;background-color:yellow;">WHO CAN USE THIS FEATURE?</mark>

User attributes and user attribute groups are managed by authorized administrators.

## Create user attributes <a href="#id-1.16.x-userattributesmanagement-createuserattributes" id="id-1.16.x-userattributesmanagement-createuserattributes"></a>

### Create a user attribute group <a href="#id-1.16.x-userattributesmanagement-createauserattributegroup" id="id-1.16.x-userattributesmanagement-createauserattributegroup"></a>

A user attribute group can have zero to multiple user attributes.

An authorized administrator can create user attribute groups through the SBO’s Attribute Groups sub-menu available in the User menu. Click ‘*Add a group of attributes*’ (figure 1) at the top of the page to create a user attribute group.

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/Eqx4XmUDfZsOUeo69D5C/image.png" alt=""><figcaption><p>Figure 1</p></figcaption></figure>

The following fields are required:

* User Attribute Group name
* Select the user categories the user attribute group will be related to (figure 2).

{% hint style="success" %} <mark style="color:green;">If no user category is selected, the user attribute group will be linked to all user categories.</mark>
{% endhint %}

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/FuiJiSHdDpLtgLCFO0Ap/image.png" alt=""><figcaption><p>Figure 2</p></figcaption></figure>

### Create a user attribute <a href="#id-1.16.x-userattributesmanagement-createauserattribute" id="id-1.16.x-userattributesmanagement-createauserattribute"></a>

Click ‘*Add an attribute*’ (figure 3) and a pop-up window will open (figure 4).

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/YY34FapfhwkLfZfU1lk0/image.png" alt=""><figcaption><p>Figure 3</p></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/r2CedHgUvIHO65h8mfgT/image.png" alt=""><figcaption><p>Figure 4</p></figcaption></figure>

The following information is required:

* “*Mandatory attribute*” to make this attribute mandatory upon profile creation
* “*Attribute name*” (mandatory)
* “*Attribute tooltip*” gives a brief description of the attribute
* “*Attribute group”* is the attribute group you link to this attribute.
* “*Type*” is the attribute type.
  * Checkbox: Checkbox attribute
  * Number: Numerical attribute
  * Date: Date picker attribute
  * Free text: Free text attribute
  * Select list: Prepopulated list attribute
* “*Add to the search engine*” checkbox to show this attribute in the search results page filters.

Click “Apply” to save the user attribute.

## Read user attributes <a href="#id-1.16.x-userattributesmanagement-readuserattributes" id="id-1.16.x-userattributesmanagement-readuserattributes"></a>

The user attributes dashboard allows authorized administrators to view all user attributes available on the platform.

User attributes are grouped under their related user attribute groups (figure 5).

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/bllVwXUk7hEkcfJEbKrg/image.png" alt=""><figcaption><p>Figure 5</p></figcaption></figure>

Each user attribute block (figure 6) displays:

* The user attribute name
* The number of user-profiles using this attribute

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/DzBcgVjuUhveJ17Zay2Y/image.png" alt=""><figcaption><p>Figure 6</p></figcaption></figure>

## Update user attributes <a href="#id-1.16.x-userattributesmanagement-updateuserattributes" id="id-1.16.x-userattributesmanagement-updateuserattributes"></a>

### User attribute groups <a href="#id-1.16.x-userattributesmanagement-userattributegroups" id="id-1.16.x-userattributesmanagement-userattributegroups"></a>

Edit a user attribute group by clicking “edit” (figure 7).

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/sD8rvCRVushIZRII6dcY/image.png" alt=""><figcaption><p>Figure 7</p></figcaption></figure>

Super-administrator and administrators can manage the group name and the related user category (figure 8).

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/GfG4vmeRdSeBILwTePyd/image.png" alt=""><figcaption><p>Figure 8</p></figcaption></figure>

### User attributes <a href="#id-1.16.x-userattributesmanagement-userattributes" id="id-1.16.x-userattributesmanagement-userattributes"></a>

Edit a user attribute by clicking “edit” (figure 9).

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/LBtG0z78sL4GT5afiDhi/image.png" alt=""><figcaption><p>Figure 9</p></figcaption></figure>

Editable information is identical to the information required during the *“create an attribute”* process.

## Delete user attributes <a href="#id-1.16.x-userattributesmanagement-deleteuserattributes" id="id-1.16.x-userattributesmanagement-deleteuserattributes"></a>

### User attribute group <a href="#id-1.16.x-userattributesmanagement-userattributegroup" id="id-1.16.x-userattributesmanagement-userattributegroup"></a>

Delete a user attribute group by clicking the trash icon (figure 10).

{% hint style="warning" %} <mark style="color:orange;">Deleting a user attribute group will also remove the attributes related to this group.</mark>
{% endhint %}

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/dBFfBEdAw0lGEQU07J2i/image.png" alt=""><figcaption><p>Figure 10</p></figcaption></figure>

### User attribute <a href="#id-1.16.x-userattributesmanagement-userattribute" id="id-1.16.x-userattributesmanagement-userattribute"></a>

Delete a user attribute by clicking the trash icon (figure 11).

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/IA2iyCsFH2GRiX1pDR1B/image.png" alt=""><figcaption><p>Figure 11</p></figcaption></figure>

## Related resources <a href="#id-1.16.x-userattributesmanagement-relatedresources" id="id-1.16.x-userattributesmanagement-relatedresources"></a>

**SBO:**

* [User categories management](https://features.scnd.com/v2.0/superadmin/users/user-categories-management)

**Dashboard:**

* [User profile dashboard (All Rendering type) - User attributes](https://features.scnd.com/dashboards/user-profile-dashboard/user-profile-dashboard-all-rendering-types#id-1.14.x-userprofiledashboard-allbundles-userattributes)
