MergeMeMergeMe/Docs

Routing

Preferences

Workspace-wide settings that apply to every mapped repository and connected git provider. Open Routing > Preferences in the dashboard.

Excluded usernames

Blocklist git usernames whose PRs/MRs and comments should not be sent to Slack. Useful for bots and automation accounts. Matching is case-insensitive. You can exclude up to 50 usernames per workspace.

Excluded usernames card with cursor and coderabbit on the blocklist and an add field
Usernames on this list are left out of Slack. Add a git username and it is saved for the workspace.

When to post the Slack card

Workspace-wide control over the first Slack card for each PR/MR:

  • Post when opened - including drafts/WIP
  • Post when ready for review - default; waits for draft/WIP to be marked ready
  • Post when a phrase is commented - waits until a PR/MR comment exactly matches your configured phrase (case-insensitive, trimmed).

This interacts with label routing: label rules are evaluated when the card is first posted (on open, ready_for_review, or when the phrase comment arrives).

When to post the Slack card, with Post when ready for review selected
Choose when the first Slack card is posted. The default waits until a draft or WIP is marked ready.

Show PR / MR number in card title

On by default. Include the PR/MR number in the Slack card heading (for example !3723 Edit README on GitLab or #42 Edit README on GitHub). Turn off for title-only headings.

Show PR/MR number in card title, turned on
On by default. The Slack card heading includes the PR/MR number.

Show CI status on Slack cards

Off by default. When enabled, MergeMe adds a CI line to each posted PR/MR card (for example CI: Running (2/5)). If optional (non-blocking) checks exist, a second bucket appears, such as Optional CI: Passed (1/1). The line updates in place as GitHub checks or GitLab pipelines run and finish. It is display-only - CI does not change review status, card color, or thread behavior, and it does not post extra Slack messages.

Show CI status on Slack cards, turned on
Off by default. Turn it on to add a CI line to each Slack card.

If CI data is missing (no pipeline yet, stale commit, or missing GitHub permissions), the row is hidden rather than showing an error.

  • GitHub.com - MergeMe needs Checks: Read and Commit statuses: Read on the GitHub App. GitHub may prompt you to approve these after an app update. If you skip the prompt, cards keep working without the CI line. See GitHub setup.
  • GitLab.com - New channel mappings register pipeline events automatically. Enable this preference, then open or update an MR so a pipeline webhook can populate the line.
  • GitLab self-hosted - Enable Pipeline events on the group or project webhook in addition to merge request and comment events. See self-hosted setup.

Mirror Git comments in the Slack thread

MergeMe posts GitLab notes, GitHub issue comments, inline review comments, and review summaries as replies under the main Slack card. Replies already in the thread stay as they are. Phrase-trigger mode still posts the first card from the matching comment, and that trigger comment is not mirrored.

Mirror Git comments in the Slack thread, turned on
Git comments are posted as replies under the main Slack card.

Post system messages in the Slack thread

MergeMe posts three system notices in the thread: "your review has been requested", "your review has been requested again", and "your PR/MR has been approved".

Post system messages in the Slack thread, turned on
Review requests and the approval notice are posted in the thread.

Status colours

Choose the sidebar colour on each Slack card for Open, Draft, In review, Partially approved, Approved, Changes requested, Merged, and Closed. Pick a preset or any #RRGGBB colour. Workspaces that leave this unset keep the colours MergeMe already posts.

Status colours preferences, with Reset in the top right, a selected preset for each PR/MR status, and a custom colour button
The ring marks the colour used for that status. The dashed + button sets a custom #RRGGBB colour. Reset restores the built-in colours.

A saved colour is used the next time that card is posted or updated, including CI-only updates. Messages already in Slack stay as they are until then.

Per-repo channel and label rules are configured under Routing overview. Scheduled stale PR/MR digests are under Reminders.