debian-mirror-gitlab/doc/user/admin_area/broadcast_messages.md

type
reference, howto

Broadcast Messages (CORE ONLY)

GitLab can display messages to all users of a GitLab instance in a banner that appears in the UI.

Broadcast messages can be managed using the broadcast messages API.

NOTE: Note: If more than one banner message is active at one time, they are displayed in a stack in order of creation.

Adding a broadcast message

To display messages to users on your GitLab instance, add broadcast message.

To add a broadcast message:

1. Navigate to the Admin Area > Messages page.
2. Add the text for the message to the Message field. Markdown and emoji are supported.
3. If required, click the Customize colors link to edit the background color and font color of the message.
4. If required, add a Target Path to only show the broadcast message on URLs matching that path. You can use the wildcard character * to match multiple URLs, for example /users/*/issues.
5. Select a date for the message to start and end.
6. Click the Add broadcast message button.

NOTE: Note: Once a broadcast message has expired, it is no longer displayed in the UI but is still listed in the list of broadcast messages. User can also dismiss a broadcast message if the option Dismissable is set.

Editing a broadcast message

If changes are required to a broadcast message, they can be edited.

To edit a broadcast message:

1. Navigate to the Admin Area > Messages page.
2. From the list of broadcast messages, click the appropriate button to edit the message.
3. After making the required changes, click the Update broadcast message button.

TIP: Tip: Expired messages can be made active again by changing their end date.

Deleting a broadcast message

Broadcast messages that are no longer required can be deleted.

To delete a broadcast message:

1. Navigate to the Admin Area > Messages page.
2. From the list of broadcast messages, click the appropriate button to delete the message.

Once deleted, the broadcast message is removed from the list of broadcast messages.

NOTE: Note: Broadcast messages can be deleted while active.