Limitations

This page introduces the usage limits of Chat, including limits to the user, the message, the group, the chatroom and the call limit of the server APIs.

The user attributes UserInfo Includes the user avatar, nickname, email address, and so on. The total length of the user information for one user must be 2 KB or less, and the total length for all users under an app must be within 10 GB or less.

The length limits of the different types of messages are as follows:

Message type	Length limit	Related API
Text message	5 KB	createTxtSendMessage
Image message	10 MB	createImageSendMessage[1/2] createImageSendMessage[2/2]
Voice message	10 MB	createVoiceSendMessage[1/2] createVoiceSendMessage[2/2]
Video message	10 MB	createVideoSendMessage[1/3] createVideoSendMessage[2/3] createVideoSendMessage[3/3]
File message	10 MB	createFileSendMessage[1/2] createFileSendMessage
Transparent transmission message	5 KB	createSendMessage
Customized extended message	The size of the extended message must not exceed that of the original message.	createSendMessage
Customized message	5 KB	createSendMessage

Group attributes

When a group createGroup is created, the length limits of the group information are as follows:

• Group name: 128 characters or less

• Group description: 512 characters or less

• Group extension information: 1024 characters or less

Chatroom attributes

When a chatroom createChatRoom is created, the length limits of the chatroom information are as follows:

• Chatroom name: 128 characters or less

• Chatroom description: 512 characters or less

Each chat room can have up to 100 custom attributes, and the total size of chat room custom attributes of each app cannot exceed 10 GB. The custom chat room attributes are of a key-value pair structure. A single key cannot exceed 128 characters and a room attribute value cannot exceed 4096 characters. Attribute keys support the following character sets:

• 26 lowercase English letters a-z;
• 26 uppercase English letters A-Z;
• 10 numbers 0 -9;
• "_", "-", ".".

The RESTful API call frequency limit of each method varies. For details about each method, see Chat RESTful API Reference.

If the provided call frequency limit cannot meet your business requirements, contact support@agora.io.