• Dark
    • PDF


    • Dark
    • PDF

    Article summary

    Configure message settings. To access this menu, navigate to Administration > Workspace > Settings > Message.

    Remember to hit Save Changes to apply any changes made.

    Basic settings

    • Custom Domain Whitelist for Auto Link: To make local server links (like http://gitlab.local) clickable, you must whitelist the corresponding custom domain. Once you've done this, any message you send that includes a URL with the custom domain will have a clickable link.

    Custom Domain Whitelist for Auto Link is available on workspaces running version 6.2 and above.

    • Allow message Editing: When enabled, users can edit messages.

    • Block Message Editing After (n) Minutes: Specify the time in minutes when users can edit messages. After this period, editing will be disabled. Enter 0 to allow unlimited editing time.

    • Allow message-deleting: Toggle on to allow users to delete messages.

    • Block Message Deleting After (n) Minutes: This lets you set a duration in minutes in which users are allowed to delete messages.

    • Allow Unrecognized Slash Commands: When enabled, unknown Slash Commands are allowed.

    • Allow user direct messages to yourself: When enabled, users can send direct messages to themselves.

    • Always Search Using RegExp: When enabled, all searches use RegExp. We recommend setting this True if your language is not supported on MongoDB text search.

    • Show Deleted Status: When enabled, shows deleted when a message is deleted.

    • Allow Message bad words filtering: Turn on to allow filtering of blacklisted words in messages.

      • Add Bad Words to the Blacklist: Takes in a list of comma-separated words that are to be filtered from the workspace.

      • Remove words from the Blacklist: Takes in any word already on the Blacklist and removes it.

    • Keep Per Message Editing History: Whether or not to keep message editing history.

    • Maximum Channel Size for ALL Message: This lets you set the maximum size of a channel.

    • Maximum Allowed Characters Per Message: This lets you specify the maximum number of characters a message can contain.

    • Allow converting long messages to attachments: When enabled, long messages can be converted to attachments.

    • Grouping Period (in seconds): Takes in time in seconds in which messages are grouped with the previous message if both are from the same user and the elapsed time was less than the informed time in seconds.

    • Embed Link Previews: Turn on to enable embedded link previews when links are posted in a chat.

      • Embed Request User Agent: This lets you set a request user agent.

      • Embed Cache Expiration Days: Set how many days the embed cache expires.

      • Embed Ignored Hosts: Comma-separated list of hosts or CIDR addresses, eg. localhost,,,,

      • Safe Ports: Comma-separated list of ports allowed for previewing.

    • Time Format: Specify the time format on your server. See also: Moment.js

    • Date Format: Set the date format on your server.

    • Time and Date Format: This lets you set the time and date format.

    • Maximum Number of Chained Quotes: This lets you set the maximum number of Chained quotes.

    • Hide System Messages: Select from a dropdown which system messages will be hidden.

    • Max users in direct messages: Specifies the maximum uses for direct messages.

    • Message Erasure Type: Select from the drop-down what to do with messages of users who removed their accounts.

    • Code highlighting languages list: Comma-separated list of languages (all supported languages at highlight.js) that are used to highlight code blocks.

    • Video Recorder Enabled: Requires video/webm files to be an accepted media type within File Upload settings.

    • Allow Message Pinning: When enabled, allow messages to be pinned to any channel.

    • Allow Message Starring: When enabled, users can star messages.

    • Allow Custom Fields in Messages: Enable this option to use custom fields for messages. For example, set priorities for messages. Note that you can only add custom fields via any of these API endpoints: Update Message, Post Message, Send Message, and Upload File to a Room.

    • Custom Fields Validation: The custom field values will be validated according to the rules defined in this setting. Check for more information regarding validation options. Properties type and additionalProperties will be forced to object and false respectively.

      For example:

      	"properties": {
      		"priority": {
      			"type": "string",
      			"nullable": false,
      			"enum": ["low", "medium", "high"]
      	"required": ["priority"]

    Hex color preview

    Enabled: Set true to allow preview for hex colors in rgba format.

    To preview a color you should write in this format: “color:#000000” and it will be displayed as:

    Hex color preview

    Message attachments

    • Enable image thumbnails to save bandwidth: When set to true, thumbnails are served instead of the original image to reduce bandwidth usage. Images at original resolution can be downloaded using the icon next to the attachment's name.

      • Thumbnail's max width (in pixels): Takes in the thumbnail's max width in pixels

      • Thumbnail's max height (in pixels): Takes in the thumbnail's max height in pixels

    • Remove EXIF metadata from supported files: Enable to strip out EXIF metadata from image files (jpeg, tiff, etc.). This setting is not retroactive, so files uploaded while disabled will have EXIF data

    Audio message

    • Audio Recorder Enabled: When set to true, users can record audio.

    • Audio Message Bit Rate: Lets you set the bit rate for audio messages.

    Read receipts

    • Show Read Receipts: Whether to show read receipts.

    • Detailed Read Receipts: This shows each user's read receipts.

    When both options are enabled, the read receipts action shows a list of users who have read the message.

    Delivered messages are indicated by a grey checkmark on the right. Once the message is read, the checkmark turns into a blue double checkmark.


    • Enable Auto-Translate: Enabling auto-translation allows users with auto-translate permission to have all messages in a room automatically translated into their selected language. To learn more, see the Auto-Translate user guide.

    • Auto-Translate for non-default language members: If enabled, any user with a language preference different from the workspace default will have the room automatically translated for them upon joining.

    • Service Provider: A drop-down to select the translation service provider. You can choose between DeepL, Google, and Microsoft.

    Add the respective API key to complete authentication for the setup depending on your selected service provider.


    Rocket.Chat does not currently support the free version of DeepL API.



    • Ocp-Apim-Subscription-Key: Enter your Microsoft Ocp-Apim-Subscription-Key. Follow the official Azure translator guide to create a translator resource and use the API key as your Microsoft Ocp-Apim-Subscription-Key.

    Google Maps

    • Enable Mapview: Enabling map view displays a location share button on the right of the chat input field.

    • Google Static Maps API Key: The Google Static Maps API Key can be obtained for free from the Google Developers Console.


    • Katex Enabled: When enabled, allows the use of katex for math typesetting in messages.

    • Allow Parenthesis Syntax: When enabled, you can use [katex block] and (inline katex) syntaxes.

    • Allow Dollar Syntax: When enabled, allows using $$katex block$$ and $inline katex$ syntaxes.

    Was this article helpful?

    What's Next

    Eddy AI, facilitating knowledge discovery through conversational intelligence