/ SDKs / JavaScript
SDKs
Chat SDKs JavaScript v4
Chat SDKs JavaScript
Chat SDKs
JavaScript
Version 4

Manage user metadata

Copy link

Metadata consists of key-value items in which you can store additional information to users. You can add up to five key-value items for user metadata. Each key can have up to 128 characters and value can have up to 190 characters as string. This section explains how to manage user metadata.


Create metadata

Copy link

You can create additional information such as phone number, email address or other descriptions to a user, which can be fetched or rendered into the UI. As an object, user metadata is stored into a User object.

To store user metadata into a User object, create Dictionary of key-value items, and then pass it as an argument to a parameter when calling the createMetaData() method. You can add multiple key-value items in the dictionary.

JavaScriptTypeScript
const data = {
    key1: 'value1',
    key2: 'value2'
};
await sb.currentUser.createMetaData(data);

Retrieve

Copy link

You can retrieve metadata stored to a user by calling the metadata property of a User object.

JavaScriptTypeScript
const value1 = user.metaData['key1'];

Update

Copy link

You can update metadata of a user by adding Dictionary of key-value items, and then pass it as an argument to a parameter when calling the updateMetaData() method. Values of existing keys will be updated and values of new keys will be added if the upsert parameter is set to true. You can put multiple key-value items in the dictionary.

JavaScriptTypeScript
const data = {
    key1: 'valueToUpdate1', // Update an existing item with a new value.
    key2: 'valueToUpdate2', // Update an existing item with a new value.
};
await sb.currentUser.updateMetaData(data);

Delete

Copy link

You can delete metadata stored to a user as below.

JavaScriptTypeScript
await sb.currentUser.deleteMetaData('key1');