# Slack Webhook

{% hint style="info" %}
This is the legacy webhook-based Slack integration. For advanced features like multiple destinations, individual test notifications, and annotation-based mentions, see [Slack App](https://docs.currents.dev/resources/integrations/slack/slack-app).
{% endhint %}

Currents integration with Slack allows posting test results of your Playwright or Cypress tests directly into Slack channels.

![Tests Results in Slack Channel](https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2Frg2ee5mVsAjYlnMXuuIN%2FCleanShot%202022-02-22%20at%2023.51.35.png?alt=media\&token=d8c3b442-5dc7-4ee6-8211-99096f54a849)

### Enabling Slack integration

In order to enable Slack integration and share Playwright test results to Slack channels, follow the steps:

* Navigate to **Manage Project > Integrations**
* Add Slack integration and provide the details:
  * **Slack Webhook URL -** Incoming Webhook URL, e.g. `https://hooks.slack.com/services/XXX/YYY/ZZZ`. Read more about [Slack Incoming Webhooks](https://api.slack.com/messaging/webhooks).
  * **Failed Runs Only** - enabling the toggle would only send results for failed runs.
  * **Events (Optional)** - specify events that will trigger the integration and send the results. Leaving this field blank activates all the events.
  * **Branch Name Filter (Optional)** - if specified, only send notifications for runs with branch names matching the pattern. Please note, that you must provide the branch name within the [run-details](https://docs.currents.dev/dashboard/runs/run-details "mention") to activate filtering.
* Click **Save** to preserve the changes

<figure><img src="https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FgnFDHBu272VGN17xrVaJ%2Fcurrents-2025-07-17-11.37.26%402x.png?alt=media&#x26;token=078b102c-f048-4c44-9eca-c2b34135fd36" alt=""><figcaption></figcaption></figure>

### Grouping Slack messages

Enabling the **Single Notification for All Groups** toggle ensures that only one notification is sent per run, regardless of how many groups it includes.

<figure><img src="https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2F2x3qg5Yb8hthRX3ttMOh%2Fcurrents-2025-07-17-11.35.37%402x.png?alt=media&#x26;token=9aafbd66-d6ed-47ed-975d-cfbb11a53ac0" alt=""><figcaption></figcaption></figure>

Note: You may still receive multiple notifications if one group finishes before the others were discovered. For example, if one group completes before the other groups are scheduled or detected, a notification may be sent early.<br>

### Filtering Slack notifications based on Tags

{% hint style="info" %}
**Please note:** We use [glob patterns](https://www.npmjs.com/package/micromatch) to evaluate the filters. Test your filtering rules using the [playground](https://currents-branch-filter.stackblitz.io/). See examples for some popular filter patterns:

* Include only **`tagA`** or **`tagB`**: `(tagA|tagB)`
* Exclude **`tagA`** an&#x64;**`tagB`**`: !(tagA|tagB)`
* Include only tags starting with **`production`**: `production*`
* Include only tags starting with **`smoke-`** or **`prod-`**`: (smoke-*|prod-*)`
  {% endhint %}

### What events trigger notifications for Slack // Currents integration?

The following events trigger notifications for Slack integration.

#### **Run Start**

Triggered when a new run starts. If a run contains multiple groups, the notification will be triggered for each group.

![Example of Slack notification for Run Start event](https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FeHAtly90SP4XsgqWOdMs%2Fslack-cypress-new-run.png?alt=media\&token=f077ce9c-1d76-4738-b63f-90381d858a2e)

#### **Run Finish**

Triggered when a run finishes its execution. If a run contains multiple groups, the notification will be triggered for each group.

![Example of Slack notification for Run Finished](https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2F07FOSfAtXSyZzVhYLy1b%2Fcypress-slack-run-finisj.png?alt=media\&token=06016df2-7013-4c0e-8491-d7c749cc89f2)

#### Run Timeout

Triggered when a time out detected for a run. The message will contain the last known results for the run or run group.

![Example of Slack notification for Run Finished with Timeout event](https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2Fj2cRAOAauG9I7F2SPz23%2Fcypress-slack-run-timeout.png?alt=media\&token=8906ba2e-3c90-44b2-aa46-8aa05d3d0541)

#### Run Canceled

Triggered when a run gets cancelled. If a run contains multiple groups, the notification will be triggered for each group. The message will contain the last known results for the run or run group.

![Example of Slack notification for Run Canceled event](https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FGqeq3btaYDSfOpBf70j5%2Fcypress-run-canceled-slack.png?alt=media\&token=9f981708-1a37-4b8f-9546-a5448afd7026)

### Disabling Slack integration

To disable Slack integration, simply delete the integration from the list of integrations.

### FAQ

#### Can I have multiple Slack integrations for the same project?

Yes, you can have multiple Slack integrations for the same project.

#### What do notification status colours mean?

<mark style="color:green;">**Green**</mark> - passed tests

<mark style="color:red;">**Red**</mark> - failed + skipped tests

**Grey** - ignored tests

<mark style="color:purple;">**Purple**</mark> - flaky tests