• App does not appear in the list of integrations
• Project or alias not found
• Slash commands return dispatch_failed in Slack
• Notifications not received to a channel
• App Home does not display properly

Troubleshooting GitLab for Slack app

When working with the GitLab for Slack app, you might encounter the following issues.

For administrator documentation, see GitLab for Slack app administration.

App does not appear in the list of integrations

The GitLab for Slack app might not appear in the list of integrations. To have the GitLab for Slack app on your self-managed instance, an administrator must enable the integration. On GitLab.com, the GitLab for Slack app is available by default.

The GitLab for Slack app is enabled at the project level only. Support for the app at the group and instance levels is proposed in issue 391526.

Project or alias not found

Some Slack commands must have a project full path or alias and fail with the following error if the project cannot be found:

GitLab error: project or alias not found

To resolve this issue, ensure:

• The project full path is correct.
• If using a project alias, the alias is correct.
• The GitLab for Slack app is enabled for the project.

Slash commands return dispatch_failed in Slack

Slash commands might return /gitlab failed with the error "dispatch_failed" in Slack.

To resolve this issue, ensure an administrator has properly configured the GitLab for Slack app settings on your self-managed instance.

Notifications not received to a channel

If you’re not receiving notifications to a Slack channel, ensure:

• The channel name you configured is correct.
• If the channel is private, you’ve added the GitLab for Slack app to the channel.

App Home does not display properly

If the App Home does not display properly, ensure your app is up to date.