Slack slash commands

note
This feature is only configurable on self-managed GitLab instances. For GitLab.com, use the GitLab for Slack app instead.

If you want to control and view GitLab content while you’re working in Slack, you can use Slack slash commands. To use Slack slash commands, you must configure both Slack and GitLab.

GitLab can also send events (for example, issue created) to Slack as notifications. The Slack notifications integration is configured separately.

Configure GitLab and Slack

Slack slash command integrations are scoped to a project.

  1. In GitLab, on the top bar, select Main menu > Projects and find your project.
  2. On the left sidebar, select Settings > Integrations.
  3. Select Slack slash commands. Leave this browser tab open.
  4. Open a new browser tab, sign in to your Slack team, and start a new Slash Commands integration.
  5. Enter a trigger command. We suggest you use the project name. Select Add Slash Command Integration.

  6. Complete the rest of the fields in the Slack configuration page using information from the GitLab browser tab. In particular, make sure you copy and paste the URL.

    Slack setup instructions

  7. On the Slack configuration page, select Save Integration and copy the Token.
  8. Go back to the GitLab configuration page and paste in the Token.
  9. Ensure the Active checkbox is selected and select Save changes.

Slash commands

You can now use the available Slack slash commands.