# Slack integration

> For the complete documentation index, see [llms.txt](/llms.txt)

> PushFeedback sends formatted feedback notifications to a Slack channel using [incoming webhooks](https://api.slack.com/messaging/webhooks). Compose the notification, preview the message, and test the destination before enabling it.

PushFeedback sends formatted feedback notifications to a Slack channel using [incoming webhooks](https://api.slack.com/messaging/webhooks). Compose the notification, preview the message, and test the destination before enabling it.

:::info
Integrations are only available on the [Professional](https://pushfeedback.com#pricing) and [Unlimited](https://pushfeedback.com#pricing) plans. On the free plan, use [email notifications](./email.md) instead.
:::

![Configure a Slack webhook, delivery controls, and message preview in PushFeedback](./images/slack-configuration.jpg)

## Prerequisites

- A PushFeedback account. If you don't have one, [sign up for free](https://app.pushfeedback.com/accounts/signup/).
- A project created in your PushFeedback dashboard. If you haven't created one yet, follow the steps in the [Quickstart](../quickstart.md#2-create-a-project) guide.
- A Slack workspace.

## Set up Slack

1. Open [app.pushfeedback.com](https://app.pushfeedback.com) and log in.

2. Go to **Projects** and select your project.

3. Click **Settings**, then under **Integrations**, select **Slack**.

4. Create an incoming webhook in Slack and paste its HTTPS URL. For detailed setup instructions, see [Slack's documentation](https://api.slack.com/messaging/webhooks). The saved URL is encrypted and is never displayed again.

5. Compose a **Notification title** and **Message template**. Use the variable buttons to insert supported values, including:

    ```text
    {{ feedback.message }}
    {{ feedback.rating_label }}
    {{ feedback.sentiment }}
    {{ feedback.email }}
    {{ feedback.url }}
    {{ feedback.detail_url }}
    {{ project.name }}
    ```

    Static text stays yours. Feedback values are formatted safely for Slack.

6. Use **Delivery controls** to pause the integration or require a written feedback message. Under **Advanced rules and custom fields**, optionally add JSON delivery rules and Slack context fields.

7. On wider screens, the event preview updates with the project's latest feedback while you edit. An empty project uses sample data. A preview does not save settings or send a Slack message.

8. Select **Test connection** to send a small test payload to the entered incoming webhook. Save the integration after the test succeeds.

## Delivery behavior

When the integration is enabled, feedback matching your delivery controls and rules is sent to the configured Slack channel.

## Remove the integration

To disconnect the Slack integration, go to the integration's settings page in your PushFeedback dashboard and click **Remove integration**. Confirming stops the integration from firing on new feedback immediately.
