Use Limits

Service Feature Limits
Feature
Limit Item
Description
One-to-one/group message
Content length
A one-to-one or group message must be no longer than 12KB.
﻿
Sending frequency
One-to-one message sending frequency: No limit for sending on the client; sending through the RESTful API is subject to the API frequency limit specified in the API documentation.Group message sending frequency: Up to 40 messages can be sent per second per group (regardless of the group type, and this limit applies to each group separately).
﻿
Receiving frequency
Android/iOS/Mac/Windows/iPad: No limit for one-to-one messages or group messagesWeb: Up to 1,000 messages/second (total of one-to-one messages and group messages) for SDK versions earlier than 2.11.2; no limit for the SDK on v2.11.2 or later.
﻿
Size of a single file
SDKs support a maximum file size of 100 MB for any single file to be sent. 
SDKs do not support creating and sending file messages. 
The IM SDK for web does not support creating and sending voice messages.
﻿
Message history storage period
The default configurations for different plans are as follows: 
Developer edition: 7 days, with no extension supported
Standard edition: 7 days, with extension supported
Premium edition: 30 days, with extension supported
The extension of the historical message storage period is a value-added service. 
UserID
Naming rule
The maximum length of a user account is limited to 32 bytes. English letters or numbers are supported. Special characters are not allowed.
User profile
Custom field
The keywords of custom fields must consist of English letters with a length no longer than 8 bytes. The length of the values of custom fields cannot exceed 500 bytes.
UserSig
Validity period
User password. The signatures generated by the default API of the IM backend SDK expire after 180 days.
Conversation management
Number of recent contacts
Each user can save up to 100 recent contacts by default. The Premium edition supports up to 500 recent contacts. The limits can be configured in the console.
User relationship chain
Friends and friend groups
A single user can have up to 3,000 friends.
The maximum number of pending friend requests supported is 100.
The maximum number of friend lists supported is 32.
The maximum length of a friend list name is 30 characters.
The maximum length of friend remarks is 96 characters.
Starting from v2.13.0, the IM SDK for web supports friend relationship chain.
﻿
Blocklist
A single user can add a maximum of 1,000 users to the blocklist.
Group
Number of groups
This refers to the total number of existing groups of all group types per `SDKAppID`, excluding disbanded groups. If the limit is reached, unnecessary groups can be disbanded first before new groups are created. The limits are as follows:
Developer edition: 100
Standard or Premium edition: No limit
﻿
Number of group members
Audio-video group (AvChatRoom): No upper limit on the number of group members. 
﻿
For non-audio-video groups, the default configurations are as follows: 
Developer edition: 20 members/group 
Standard edition: 200 members/group, which can be extended to 2,000 members/group
Premium edition: 2,000 members/group, which can be extended to 6,000 members/group
﻿
Number of groups a user can join
This refers to the total number of groups of all group types that a user can join. The limits are as follows: 
Developer edition: 50 groups/user
Standard edition: 500 groups/user, which can be extended to 1,000 groups/user
Premium edition: The limit can be extended to 3,000 groups/user
﻿
Group profile
The maximum length of the group name is 30 bytes.
The maximum length of the group introduction is 240 bytes.
The maximum length of the group announcement is 300 bytes.
The maximum length of the group profile photo URL is 100 bytes.
The maximum length of the group name card is 50 bytes.
﻿
Custom group ID
The custom group ID must be printable ASCII characters (0x20-0x7e) with maximum length limited to 48 bytes. It cannot begin with @TGS# so as to avoid confusion with the default group IDs assigned by IM.
﻿
Group custom field
Groups support up to 10 custom fields: 
The Key field is String type, with a maximum length of 16 bytes. Its name can contain only uppercase and lowercase letters, numbers, and underscores.
The Value field is a user-defined buffer and can be binary data. The maximum Value length for groups is 512 bytes.
﻿
Group member custom field
Group Member supports up to 5 custom fields: 
The Key field is String type, with a maximum length of 16 bytes. Its name can contain only uppercase and lowercase letters, numbers, and underscores. 
The Value field is a user-defined buffer and can be binary data. The maximum Value length for Group Member is 64 bytes.
﻿
Number of topics in a community
Currently, a community supports up to 200 topics.
﻿
API-related Limits
Note
 This document lists only the RESTful APIs that have use limits. For a complete list of APIs, see RESTful APIs.
General limits
Limit Item
Description
Call frequency
Up to 100 times/second: importing multiple accounts, deleting accounts and querying accounts
Up to 200 times/second: other RESTful APIs
﻿
Account management
API
Description
Importing multiple accounts
Up to 100 user names can be imported at a time, and this API does not support directly importing nickname and profile photo information of accounts.
Querying online status of accounts
A single request can query the status of up to 500 users.
﻿
One-to-one message
API
Description
Sending one-to-one messages in batches
A single request can send one-to-one messages to up to 500 users.
﻿
Relationship chain management
API
Description
Importing friends
A single request can import up to 1,000 friends.
﻿
Group management
API
Description
Adding group members
A maximum of 100 members can be added at a time.
Deleting group members
A single request can delete up to 500 members.
Querying a user’s identity in the group
A single request can query up to 500 accounts.
Batch muting and unmuting
A single request can mute/unmute up to 500 accounts.
Sending ordinary messages in a group
The default sending frequency of a single group is limited to 40 messages/second. If two messages sent within 5 minutes from the same sender have the same random value (Random parameter), the later message will be discarded as a duplicate message.
Importing group messages
A maximum of 20 messages can be imported by a single request. Messages must be imported in ascending order by timestamp. The timestamps of imported messages must be earlier than the current time and later than the group creation time. Otherwise, the import fails.
Importing group members
Audio-video groups (AVChatRoom) do not support importing members.Up to 300 members can be imported in one request. However, different group types have different group member limits. For more information, see Group Features.
﻿

Service Feature Limits
API-related Limits

Feature	Limit Item	Description
One-to-one/group message	Content length	A one-to-one or group message must be no longer than 12KB.
		Sending frequency	One-to-one message sending frequency: No limit for sending on the client; sending through the RESTful API is subject to the API frequency limit specified in the API documentation.Group message sending frequency: Up to 40 messages can be sent per second per group (regardless of the group type, and this limit applies to each group separately).
		Receiving frequency	Android/iOS/Mac/Windows/iPad: No limit for one-to-one messages or group messagesWeb: Up to 1,000 messages/second (total of one-to-one messages and group messages) for SDK versions earlier than 2.11.2; no limit for the SDK on v2.11.2 or later.
		Size of a single file	SDKs support a maximum file size of 100 MB for any single file to be sent. SDKs do not support creating and sending file messages. The IM SDK for web does not support creating and sending voice messages.
		Message history storage period	The default configurations for different plans are as follows: Developer edition: 7 days, with no extension supported Standard edition: 7 days, with extension supported Premium edition: 30 days, with extension supported The extension of the historical message storage period is a value-added service.
UserID	Naming rule	The maximum length of a user account is limited to 32 bytes. English letters or numbers are supported. Special characters are not allowed.
User profile	Custom field	The keywords of custom fields must consist of English letters with a length no longer than 8 bytes. The length of the values of custom fields cannot exceed 500 bytes.
UserSig	Validity period	User password. The signatures generated by the default API of the IM backend SDK expire after 180 days.
Conversation management	Number of recent contacts	Each user can save up to 100 recent contacts by default. The Premium edition supports up to 500 recent contacts. The limits can be configured in the console.
User relationship chain	Friends and friend groups	A single user can have up to 3,000 friends. The maximum number of pending friend requests supported is 100. The maximum number of friend lists supported is 32. The maximum length of a friend list name is 30 characters. The maximum length of friend remarks is 96 characters. Starting from v2.13.0, the IM SDK for web supports friend relationship chain.
User relationship chain		Blocklist	A single user can add a maximum of 1,000 users to the blocklist.
Group	Number of groups	This refers to the total number of existing groups of all group types per `SDKAppID`, excluding disbanded groups. If the limit is reached, unnecessary groups can be disbanded first before new groups are created. The limits are as follows: Developer edition: 100 Standard or Premium edition: No limit
		Number of group members	Audio-video group (AvChatRoom): No upper limit on the number of group members. For non-audio-video groups, the default configurations are as follows: Developer edition: 20 members/group Standard edition: 200 members/group, which can be extended to 2,000 members/group Premium edition: 2,000 members/group, which can be extended to 6,000 members/group
		Number of groups a user can join	This refers to the total number of groups of all group types that a user can join. The limits are as follows: Developer edition: 50 groups/user Standard edition: 500 groups/user, which can be extended to 1,000 groups/user Premium edition: The limit can be extended to 3,000 groups/user
		Group profile	The maximum length of the group name is 30 bytes. The maximum length of the group introduction is 240 bytes. The maximum length of the group announcement is 300 bytes. The maximum length of the group profile photo URL is 100 bytes. The maximum length of the group name card is 50 bytes.
		Custom group ID	The custom group ID must be printable ASCII characters (0x20-0x7e) with maximum length limited to 48 bytes. It cannot begin with @TGS# so as to avoid confusion with the default group IDs assigned by IM.
		Group custom field	Groups support up to 10 custom fields: The Key field is String type, with a maximum length of 16 bytes. Its name can contain only uppercase and lowercase letters, numbers, and underscores. The Value field is a user-defined buffer and can be binary data. The maximum Value length for groups is 512 bytes.
		Group member custom field	Group Member supports up to 5 custom fields: The Key field is String type, with a maximum length of 16 bytes. Its name can contain only uppercase and lowercase letters, numbers, and underscores. The Value field is a user-defined buffer and can be binary data. The maximum Value length for Group Member is 64 bytes.
		Number of topics in a community	Currently, a community supports up to 200 topics.

Limit Item	Description
Call frequency	Up to 100 times/second: importing multiple accounts, deleting accounts and querying accounts Up to 200 times/second: other RESTful APIs

API	Description
Importing multiple accounts	Up to 100 user names can be imported at a time, and this API does not support directly importing nickname and profile photo information of accounts.
Querying online status of accounts	A single request can query the status of up to 500 users.

API	Description
Sending one-to-one messages in batches	A single request can send one-to-one messages to up to 500 users.

API	Description
Importing friends	A single request can import up to 1,000 friends.

API	Description
Adding group members	A maximum of 100 members can be added at a time.
Deleting group members	A single request can delete up to 500 members.
Querying a user’s identity in the group	A single request can query up to 500 accounts.
Batch muting and unmuting	A single request can mute/unmute up to 500 accounts.
Sending ordinary messages in a group	The default sending frequency of a single group is limited to 40 messages/second. If two messages sent within 5 minutes from the same sender have the same random value (Random parameter), the later message will be discarded as a duplicate message.
Importing group messages	A maximum of 20 messages can be imported by a single request. Messages must be imported in ascending order by timestamp. The timestamps of imported messages must be earlier than the current time and later than the group creation time. Otherwise, the import fails.
Importing group members	Audio-video groups (AVChatRoom) do not support importing members.Up to 300 members can be imported in one request. However, different group types have different group member limits. For more information, see Group Features.