Select your Platform:
Overview
Confused about "Overview"?
Let us know how we can improve our documentation:
Application level settings allow you to configure settings that impact all the channel types in your app. Our backend SDKs make it easy to change the app settings. You can also change most of these using the CLI or the dashboard. Here's an example on changing the disable_auth_checks setting:
A full overview of available settings can be found below:
Permissions
Copied!Confused about "Permissions"?
Let us know how we can improve our documentation:
The following app settings allow you to control how permissions work for your app:
NAME | DESCRIPTION | DEFAULT |
|---|---|---|
disable_auth_checks | Disabled authentication. Convenient during testing and allows you to use devTokens on the client side. Should not be used in production. | false |
disable_permissions_checks | Gives all users full permissions to edit messages, delete them etc. Again not recommended in a production setting, only useful for development. | false |
Push
Copied!Confused about "Push"?
Let us know how we can improve our documentation:
NAME | DESCRIPTION | DEFAULT |
|---|---|---|
apn_config | APN config object. See details. | |
firebase_config | Firebase config object. See details. | |
huawei_config | Huawei config object. See details. | |
xiaomi_config | Xiaomi config object. See details. | |
push_config | Global config object. See details. |
CDN
Copied!Confused about "CDN"?
Let us know how we can improve our documentation:
NAME | DESCRIPTION | DEFAULT |
|---|---|---|
cdn_expiration_seconds | CDN URL expiration time. See details. | 1209600 (14 days) |
Hooks
Copied!Confused about "Hooks"?
Let us know how we can improve our documentation:
Hooks enable you to listen to changes in chat. You can use either webhooks or SQS.
NAME | DESCRIPTION | DEFAULT |
|---|---|---|
webhook_url | This webhook is useful when you want your server application to receive all important events happening in the Stream Chat | - |
custom_action_handler_url | This webhook reacts to custom /slash commands and actions on those commands/ MML | - |
before_message_send_hook_url | This webhook allows you to modify or moderate message content before sending it to the chat for everyone to see | - |
sqs_url | Your SQS url | - |
sqs_key | The key for SQS queue | - |
sqs_secret | The secret for your SQS queue | - |
Moderation & Translation
Copied!Confused about "Moderation & Translation"?
Let us know how we can improve our documentation:
The following settings allow you to control moderation for your chat:
NAME | DESCRIPTION | DEFAULT |
|---|---|---|
image_moderation_labels | Moderation scores returned from the external image moderation API | - |
image_moderation_enabled | If image moderation AI should be turned on | - |
enforce_unique_usernames | If Stream should enforce username uniqueness. This prevents people from joining the chat as "elonmusk" while "elonmusk" is presenting. | - |
auto_translation_enabled | If Stream should automatically translate messages | - |
async_url_enrich_enabled | If url enrichment should be done async. It will trigger message.updated event | - |
File Uploads
Copied!Confused about "File Uploads"?
Let us know how we can improve our documentation:
You can set restrictions on file uploads by including a file_upload_config object. You can set either an inclusive list using allowed_file_extensions and allowed_mime_types or an exclusive list using blocked_file_extensions and blocked_mime_types.
The file_upload_config object accepts the following fields:
NAME | DESCRIPTION | Example | Default |
|---|---|---|---|
allowed_file_extensions | An array of file types that the user can submit. Files with an extension that does not match the values in this array will be rejected. |
| - |
blocked_file_extensions | An array of file types that the user can submit. Files with an extension that does not match the values in this array will be rejected. |
| - |
allowed_mime_types | An array of file MIME types that the user can submit. Files with an MIME type that does not match the values in this array will be rejected. Must follow the |
| - |
blocked_mime_types | An array of file types that the user can submit. Files with an MIME type that does not match the values in this array will be rejected. Must follow the |
| - |
size_limit | A number that represents the maximum accepted file size in bytes. In case its 0 the default maximum is used. | 10485760 | 0 |
For example, the following code shows how to block all attempts to upload any files that are not .csv:
Image Uploads
Copied!Confused about "Image Uploads"?
Let us know how we can improve our documentation:
You can set restrictions on file uploads by including an image_upload_config object. You can set either an inclusive list using allowed_file_extensions and allowed_mime_types or an exclusive list using blocked_file_extensions and blocked_mime_types.
The image_upload_config object accepts the following fields:
NAME | DESCRIPTION | Example | Default |
|---|---|---|---|
allowed_file_extensions | An array of file types that the user can submit. Files with an extension that does not match the values in this array will be rejected. |
| - |
blocked_file_extensions | An array of file types that the user can submit. Files with an extension that does not match the values in this array will be rejected. |
| - |
allowed_mime_types | An array of file MIME types that the user can submit. Files with an MIME type that does not match the values in this array will be rejected. Must follow the |
| - |
blocked_mime_types | An array of file types that the user can submit. Files with an MIME type that does not match the values in this array will be rejected. Must follow the |
| - |
size_limit | A number that represents the maximum accepted file size in bytes. In case its 0 the default maximum is used. | 10485760 | 0 |
For example, the following code shows how to block all attempts to upload any files that are not gif, jpeg, or png files:
image/bmp, image/gif ,image/jpeg, image/png, image/webp, image/heic, image/heic-sequence, image/heif, image/heif-sequence, image/svg+xml. Applications can set a more restrictive list, but would not be allowed to set a less restrictive list.