Message Settings

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

Remember to hit Save Changes to apply any changes made.

General message settings

Field

Description

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. Enter the domains as comma-separated values.

This option is available on workspaces running version 6.2 and above.

Allow message Editing

When this option is enabled, users can edit messages that they’ve sent.

Block Message Editing After (n) Minutes

Specify the time (in minutes) within which users can edit messages. After this period, editing will be disabled. Enter 0 to allow unlimited editing time.

Allow message-deleting

Enable this option to allow users to delete messages that they’ve sent.

Block Message Deleting After (n) Minutes

Set a duration (in minutes) in which users are allowed to delete messages. Enter 0 to allow unlimited time.

Allow Unrecognized Slash Commands

When this option is enabled, unknown slash commands are allowed. If the slash command does not exist, it is sent as a normal message.

If this option is disabled and a user sends a slash command that does not exist, the rocket.cat bot sends the message No such command: <command>. This message is only visible to the sender in the channel.

Allow user direct messages to yourself

When this option is enabled, users can send direct messages to themselves.

Always Search Using RegExp

When this option is enabled, all searches use RegExp. We recommend enabling this setting if your language is not supported on MongoDB text search.

Show Deleted Status

When this option is enabled, the channel displays deleted when a message is deleted.

Allow Message bad words filtering

Enable this option to allow filtering of blacklisted words in messages.

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

  • Remove words from the Blacklist: Enter any word already on the blacklist. It will be removed from the channel.

Keep Per Message Editing History

Enable this option if you want to keep message editing history.

Maximum Channel Size for ALL Message

Set the maximum size of a channel.

Maximum Allowed Characters Per Message

Specify the maximum number of characters a message can contain.

Allow converting long messages to attachments

When this option is enabled, long messages can be converted to attachments. When a long message is sent to a room, a pop-up window prompts users to send the message as a .txt file attachment.

Grouping Period (in seconds)

Enter the 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

Enable embedded link previews when links are posted in a chat.

Modify the following settings:

  • 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, 127.0.0.1, 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16

  • 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

Set the time and date format.

Maximum Number of Chained Quotes

Set the maximum number of message quotes that can be displayed in one message. Chained quotes appear as nested messages.

Hide System Messages

Select the system messages from the drop-down menu that will be hidden in rooms.

Max users in direct messages

Specify the maximum users for multi-user DMs.

Message Erasure Type

Determine 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

Enable this option to record video messages and upload. Requires video/webm files to be an accepted media type within File Upload settings.

Allow Message Pinning

When this option is enabled, users can pin messages to rooms.

Allow Message Starring

When this option is 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 in messages are exclusively available to workspaces from 6.8.0.

Custom Fields Validation

The custom field values will be validated according to the rules defined in this setting. Check ajv.js.org 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"]
}

Enable hex color preview

To access this setting, go to Administration > Workspace > Settings > Message > Hex Color Preview. Enable this option 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:

Message attachment settings

To access this setting, go to Administration > Workspace > Settings > Message > Message Attachments.

Field

Description

Enable image thumbnails to save bandwidth

When this option is enabled, 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.

Enter the values for the following settings:

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

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

Remove EXIF metadata from supported files

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

Audio message settings

To access this setting, go to Administration > Workspace > Settings > Message > Audio Message.

Field

Description

Audio Recorder Enabled

Enable this option to allow users to send audio messages.

Audio Message Bit Rate

Set the bit rate for audio messages.

Google Maps

To access this setting, go to Administration > Workspace > Settings > Message > Google Maps.

Field

Description

Enable Mapview

Enabling map view displays a location share button on the right of the chat input field. Users can share their locations to rooms.

Google Static Maps API Key

The Google Maps Static API key can be obtained for free from the Google Developers Console.

Katex

To access this setting, go to Administration > Workspace > Settings > Message > Katex.

Field

Description

Katex Enabled

When this option is enabled, it allows the use of katex for math typesetting in messages.

Allow Parenthesis Syntax

When this option is enabled, you can use [katex block] and (inline katex) syntaxes.

Allow Dollar Syntax

When this option is enabled, it allows using $$katex block$$ and $inline katex$ syntaxes.