Connect Slack

Last updated: October 23, 2026

Connecting Slack to OverlayQA posts issue notifications to your team channel. When an issue is created or assigned, a rich message appears in Slack with severity, project, screenshot, and a link to view the issue in OverlayQA.

Connect Your Slack Workspace

Open the OverlayQA dashboard and go to Settings.
In the Slack integration card, click Connect.
A Slack authorization page opens in a new tab. Select your workspace and approve access.
The settings page updates when the connection is detected.

Tip: You only need to connect once. After the initial OAuth authorization, OverlayQA remembers your Slack connection.

Select a Channel

After connecting, click Select channel to choose where notifications are posted. You can pick any public or private channel the OverlayQA bot has been invited to.

Tip: For private channels, invite the OverlayQA bot to the channel first. It will not appear in the channel picker until invited.

What Gets Posted

OverlayQA posts a Slack message when:

An issue is created: includes severity, type, project name, creator, screenshot (if available), and a "View in OverlayQA" button.
An issue is assigned: includes the assignee name, issue title, project, and a link to view the issue.

Test Your Connection

After selecting a channel, click Test to send a sample message. This confirms the bot can post to your selected channel.

Change or Disconnect

To change the notification channel, click Change channel in the Slack integration card. To disconnect Slack entirely, click Disconnect.

OverlayQA project settings showing Figma file, privacy, and shared links configuration

Act From Slack

Your team can work on an issue straight from its notification. Replies, reactions, commands and buttons in Slack update the OverlayQA issue:

Thread replies: Any reply in the notification thread syncs as a comment on the OverlayQA issue.
Emoji reactions: React with ✅ to mark an issue resolved, 👀 to mark it in review, or ❌ to reopen it. Status updates reflect in OverlayQA.
Slash commands: Use /overlayqa resolve <issue-id> to close an issue, or /overlayqa reopen <issue-id> to reopen it. Aliases: close and done work like resolve; open works like reopen. The issue ID can optionally include a # prefix.
Action buttons: Each notification message includes a Resolve button and a View in OverlayQA link. Click Resolve to close the issue directly from Slack. Once resolved, the button changes to Reopen so you can reverse the action.

Tip: Developers can triage and resolve issues without opening the OverlayQA dashboard. The Slack thread becomes the conversation record for the issue.

Slash Command Reference

Command	Effect
`/overlayqa resolve <id>`	Marks the issue as resolved and sets the resolved timestamp.
`/overlayqa reopen <id>`	Reopens a resolved issue and clears the resolved timestamp.
`/overlayqa close <id>`	Alias for resolve.
`/overlayqa done <id>`	Alias for resolve.
`/overlayqa open <id>`	Alias for reopen.

Slash command responses are visible to the entire channel, showing who performed the action and the issue title. Error messages (issue not found, already resolved, workspace not connected) are shown only to the user who ran the command.