Limits
Update time: 2025/08/25 15:56:39
Messaging
| Feature | Limit |
|---|---|
| Message body | The maximum length of the body field is limited to 5,000 characters. |
| Image message | No limit is applied. Implement limits based on your business requirements. |
| Audio message | The default recording duration lasts 120 seconds (custom configuration is supported). The file size is unlimited. Implement limits based on your business scenario. |
| Video message | The video duration and size are unlimited. Implement limits based on your business scenario. |
| File message | Size of upload files from the SDK is unlimited. The maximum size of upload files from the server is 15 MB. Implement limits based on your business scenario. |
| offline messages | For peer-to-peer chats: the last 5,000 offline messages within 30 days are delivered (up to 100 messages per session). For group chats: offline messages for the last 30 days are delivered (up to 100 messages per session). Note: Offline messages for chat rooms are not supported. |
| Roaming message | Roaming messages in the last 100 sessions within 7 days, the last 100 messages per session are roamed |
| Validity period for P2P chat or group chat message history | 7 days for the free tier; 1 year for IM Pro, up to 3 years can be extended (value-added) |
| Validity period for chat room message history | 10 days |
| the NOS storage service | Free tier: 1 TB; IM Pro: 1 TB, up to 1000 TB can be extended (value-added) |
For the charges of the previous value-added features, see Pricing.
Friends data
| Feature | Limit |
|---|---|
| Number of friends | 3,000 friends can be added by default, and 10,000 friends can be extended. |
User profile
| Parameter | Type | Description |
|---|---|---|
| accid | string | User account, up to 32 characters, unique within your app. |
| name | string | The nickname can contain up 64 characters |
| icon | string | User icon, up to 1024 characters. |
| sign | string | Bio, up to 256 characters. |
| string | The email can contain up 64 characters. | |
| birth | string | User icon, up to 16 characters. |
| mobile | string | Mobile phone number, up to 32 characters, only phone numbers registered in China are supported |
| gender | int | Gender, 0: Prefer not to respond, 1: male, 2: female. Other values return an error. |
| ex | string | Profile extension field, up 1,024 characters are allowed. You can customize the field. A JSON string is preferred. |
Group channel
| Feature | Limit |
|---|---|
| Group channel capacity | 200 participants/group. You can increase the quota up to 5,000 participants/group. |
| Number of groups created per account | 100 groups per account. 50 groups for the free tier. You can increase to 5,000 groups (add-on). |
| Number of groups a user can join | A user can join 5,000 groups. |
Chat room
| Feature | Limit |
|---|---|
| Chat room capacity | No limit is applied |
| Number of chat rooms a user can create | 200 chat rooms per user. To expand the quota, contact the sales team. |
| Multi-device logins for the same chat room | By default, only one device is allowed to join a chat room at the same time. You can configure the settings in the CommsEase console. |
To configure settings, log in to the console.
Event subscription
| Feature | Limit |
|---|---|
| Subscription | Subscribe to the online status events of specified users. Each account has a maximum of 3,000 valid subscription accounts. |
Rate limit
| Feature | Limit |
|---|---|
| Message flow control in chat rooms | By default, 20 regular messages and 10 high-priority messages can be sent in one second. |
| Send a message | 100 calls per second by default. |
| Send a custom system notification | 100 calls per second by default. |
| Send multiple common messages at a time | 120 calls per second by default. |
| Send multiple system notifications at a time | 120 calls per second by default. |
| Group management operations | 100 calls per second by default. |
| Send a broadcast message | 10 calls per second by default. |
| Send a message in a chat room | 100 calls per second by default. |
| Send a broadcast message across all chat rooms | 10 calls per second by default. |
Was this page helpful?