[**RongIMLib**](../README.md)

***

[RongIMLib](../globals.md) / addTag

# Function: addTag()

> **addTag**(`tag`): `Promise`\<[`RCResult`](../interfaces/RCResult.md)\<`void`\>\>

创建标签

## Parameters

### tag

[`ITagParam`](../interfaces/ITagParam.md)

标签信息，包含标签 ID 和标签名称，类型为 [ITagParam](../interfaces/ITagParam.md)

## Returns

`Promise`\<[`RCResult`](../interfaces/RCResult.md)\<`void`\>\>

创建成功返回 code 为 0，失败返回错误码

## Description

创建标签系统，用于对会话进行管理。SDK 创建的标签会被同步到服务端
SDK 支持使用一个或多个标签标记会话，可用于会话的分组显示、获取会话列表等操作，并提供了多个接口用于移除会话上的标签
**注意**：每个用户最多可以创建 20 个标签

## Example

**创建标签示例：**

```ts
const tag = {
 tagId: 'tagId',
 tagName: 'tagName',
};
const res = await RongIMLib.addTag(tag);
console.log('创建标签结果：', res);
```