Integration for Slack

Trunk Merge Queue integrates with Slack to send real-time notifications about queue activity and pull request state changes. You can route notifications to multiple Slack channels per repository, each with its own set of enabled topics, and receive personal DMs about your own PRs directly in Slack.

​

Installing the Trunk Slack App

Before you can set up channel notifications or personal DMs, a Slack workspace admin must install the Trunk Slack app for your organization. This is a one-time setup that enables all Slack integration features.

​

Steps to Install

1. In the Trunk web app, navigate to Settings → Organization → Slack.
2. Click Add to Slack.
3. Review and approve the requested permissions on the Slack OAuth screen.
4. You’ll be redirected back to Trunk. The page will show your workspace as Connected along with the workspace name.

​

Managing the Connection

Once connected, you can Reconnect (to reauthorize) or Disconnect the workspace from the same settings page.

​

Channel Notifications

Send merge queue updates to one or more shared Slack channels to keep your team informed about queue activity. Each channel can have its own set of enabled notification topics.

​

Connecting Slack Channels

1. Navigate to Merge Queue → [your repository] → Settings.
2. Under Slack Notifications, click Add Channel.
3. In the Add Slack Channel modal, paste your Slack channel link. To get the link: right-click the channel name in Slack and select Copy link. Trunk looks up the channel and displays its name when found.
4. Toggle the notification topics you want enabled for that channel.
5. Click Connect.

You can connect multiple channels, each with a different set of enabled topics. For example, you might send all notifications to a #merge-notifications channel while only sending failure alerts to a #merge-queue-failures channel. The channel list displays each connected channel along with a summary of how many notification topics are enabled (e.g., “6/9 enabled”). To remove an individual channel, click the trash icon next to it. To remove all channel connections for the repository, click Disconnect.

​

Managing Channel Notification Preferences

Each connected channel has its own independent set of notification topics. You can expand any channel in the list to view and toggle its topics on or off. Changes take effect immediately. See Available Notification Topics below for descriptions of each notification type.

​

Personal Slack Notifications

Get direct messages in Slack about your PRs as they move through the merge queue — queued, testing, merged, failed, and more — without adding noise to team channels.

​

Setting up Personal Notifications

Personal notification setup is done from the Trunk Slack app’s Home tab in Slack:

1. Open the Trunk app in Slack. If you don’t see it in your sidebar, add it via Apps → Manage → Browse Apps and search for “Trunk.”
2. Open the Home tab.
3. Click Link Account to connect your Trunk account to Slack.
4. Connect your GitHub account from the Home tab. This is required for PR tracking and most notifications.
5. Configure your notification preferences using the toggles on the Home tab.

​

Using the Trunk Web UI

You can also start setup from the Trunk web app, which will redirect you to Slack to complete the process:

1. Navigate to Settings → Account → Notifications in Trunk.
2. Under Connect your Slack workspace, verify your workspace is connected. If not, click Go to Slack settings to install the app first.
3. Click Open in Slack to jump to the Trunk app’s Home tab, where you’ll link your account and configure notifications.

​

Slack App Home Dashboard

The Trunk Slack app’s Home tab provides a personal merge queue dashboard directly in Slack. Open the Trunk app in Slack and click the Home tab to see an overview of your merge queue activity across all repositories.

​

What You’ll See

The Home tab displays the following sections:

• Refresh — A button at the top of the Home tab to update the view with the latest queue data, along with a “Last refreshed” timestamp.
• Account connection status — Shows your connected identity (e.g., “Connected as Your Name”), an Unlink Account button, and your GitHub account connection status. You can connect your GitHub account directly from the Home tab if it isn’t linked yet.
• Not Ready — PRs you’ve submitted that are waiting for prerequisites (e.g., GitHub mergeability) before entering the queue.
• PRs in Queue — Your PRs that are currently in the queue, with real-time status indicators (e.g., “Testing”).
• Recently Merged PRs — Your most recently merged PRs, with merge dates.
• Failed PRs — Your PRs that failed in the queue.
• Notification Preferences — Toggle buttons for all notification topics. You can enable or disable individual notifications directly from Slack without visiting the web UI.

All PR sections are grouped by repository and branch. Each PR entry shows the title, PR number, and a link to the GitHub PR. Data is shown across all merge queues you submit to, scoped to your PRs via your linked GitHub account.

​

Linking Your Account

To use the Home tab, you need to link your Trunk and GitHub accounts. Follow the steps in Setting up Personal Notifications — the same account linking process powers both the dashboard and personal DMs.

​

Managing Notification Preferences

You can toggle notification topics on or off directly from the Home tab — no need to visit the Trunk web UI. Changes take effect immediately. The available topics are the same as those listed in Available Notification Topics.

​

Frequently Asked Questions

​

Available Notification Topics

Both channel and personal Slack notifications support the same notification topics. You can customize which events trigger notifications for each channel or for your personal DMs.