# Custom properties

From the audience table, you can create custom properties to add more information about your members. All custom properties are then displayed in the columns of the audience table. You'll also find them in members' public profiles. 

You can find and manage all your custom properties from the menu `Properties` on the top of the audience table.

<figure><img src="https://3055204660-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrzBxnWaSListMwx3rzKu%2Fuploads%2FXu84GnI3PnVB3otzpgXx%2Fimage.png?alt=media&#x26;token=2cd09648-95e8-462d-bd66-00d88798b108" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Custom properties are only visible to admins.&#x20;
{% endhint %}

## Custom property&#x20;

For each custom property, you can display all its characteristics in a drawer by clicking :&#x20;

* On the property name in the audience table column list (click on the `Properties` button next to the `Filters` button to display it).
* On the `Manage property` button in the column menu (click on the three dots next to the column title).&#x20;

In the property's drawer, you'll find :&#x20;

* The property name with a tag indicating its type.&#x20;
* A `Details` section containing :&#x20;
  * The property slug, with a `Copy` icon that lets you copy the slug to the clipboard.&#x20;
  * The property description.&#x20;

{% hint style="info" %}
The slug is a label that identifies the property and enables it to be manipulated via the API and SSO.&#x20;
{% endhint %}

* A `Values` section (if the property type is `Multiple Select`, `Single Select` or `Boolean`) containing :&#x20;
  * The various possible values.&#x20;
  * For each value, the number of members who have that value for the property.&#x20;
* A `Linked Data` section:&#x20;
  * The number of members who have a value for this property.&#x20;

At the bottom of the drawer, a `Edit` button opens the drawer for editing the property.&#x20;

## Create a property&#x20;

To create a property, click on `Action`, then on `Create property`. A drawer opens:&#x20;

* Choose the property **type**: `Text`, `Single select`, `Multiple select`, `Boolean`, `Number` or `Date` - *Mandatory*.&#x20;
* Give the **role** a name (*mandatory*) and a **description** (*optional*).&#x20;
* If it's a `Single select` or `Multiple select` property:&#x20;
  * Two **answers** are pre-created (`Value 1` and `Value 2`): you can modify, reorder or delete them.&#x20;
  * You can add values using the `Add value` button.&#x20;
  * **Please note** that at least 2 answers are required.&#x20;
* Click on `Create`: your property is ready to be filled in! :clap:

## Modify a property&#x20;

You can modify a property. To do so, click on the `Edit` button in the property's drawer. An edit drawer opens, from which you can modify :&#x20;

* Property name. **Please note** that if you modify the property name, the slug name remains unchanged.&#x20;
* Description.&#x20;
* Property values (if `Single select` or `Multiple select`):&#x20;
  * If a value is modified, it will also be modified for members who already have this value.&#x20;
  * If a value is deleted, members with this value will no longer have a value for this property.&#x20;
  * If a value is added, nothing changes for members who already have a value.&#x20;

When you click on `Save`, the property is modified.&#x20;

You can also delete the property: when you click on `Delete`, a confirmation dialog box opens. If you choose to delete the property, **this choice will be definitive and irreversible.** *Use with caution* :wink:&#x20;

{% hint style="info" %}
Once a property has been created, you can no longer modify its slug.&#x20;
{% endhint %}

## Edit a property's value&#x20;

Once you've created your property, you can fill it in for the different members of your audience!&#x20;

{% hint style="info" %}
By default, members have empty values for each custom property created.
{% endhint %}

There are several ways to modify property values:&#x20;

* [From your audience within your Spot.](#manual-editing)
* [Via the JWT token (SSO). ](#editing-via-sso-login)
* [Via the API. ](#edit-via-api)

### Manual editing&#x20;

#### Member profile&#x20;

All personalized properties are displayed in the member's public profile. To change the value of a property, click on the button :pen\_fountain:  beside it. A window opens, allowing you to modify the value. If the member already has a value for this property :&#x20;

* The modal is already pre-filled with this value.&#x20;
* A `Clear Value` button allows you to delete this existing value for the member.&#x20;

{% hint style="info" %}
If the member has a value for a property, an icon :information\_source:  appears to the right of this value. When you move the mouse over this icon, a tooltip tells you how the value was filled in (`Manually`, `SSO` or `API`).&#x20;
{% endhint %}

#### Bulk edit&#x20;

From the audience table, you can change the value of a property for several members of your Spot at once. To do this:&#x20;

* Select the members concerned.
* Click on the `Action` button.
* Click on the `Edit property value` button in the menu that appears.&#x20;
* Select the property whose value you wish to edit.

A window opens, allowing you to modify the value of this property! All you have to do is enter the value of your choice, and it will be applied to all the members you have selected.&#x20;

### Editing via SSO login&#x20;

You can modify the value of a member's properties at the time of authentication via SSO. :point\_right: [more information here ](https://help.meltingspot.io/english/manage-spot/sso)

### Edit via API&#x20;

You can modify a member's property values via the API. To do this, you have three different endpoints at your disposal:&#x20;

* List custom property values for a member.
* Modify the value of a custom property for a member.&#x20;
* Modify or add multiple custom property values for a member.

:point\_right: [more information here](https://help.meltingspot.io/english/manage-spot/audience/members/broken-reference)