# Page Feedback \[Collect page-level feedback from readers]

## Setup

Enable feedback by adding a feedback adapter to your config:

```ts twoslash [vocs.config.ts]
import { defineConfig, Feedback } from 'vocs/config'

export default defineConfig({
  feedback: Feedback.slack()
})
```

## Slack Adapter

The Slack adapter sends feedback to a Slack channel via an [incoming webhook](https://api.slack.com/messaging/webhooks).

### Creating a Slack App

1. Go to [api.slack.com/apps](https://api.slack.com/apps) and click **Create New App**
2. Choose **From scratch**
3. Name your app and select your workspace
4. In the sidebar, go to **Incoming Webhooks**
5. Toggle **Activate Incoming Webhooks** to On
6. Click **Add New Webhook to Workspace**
7. Select the channel where feedback should be posted
8. Copy the webhook URL

### Configuration

Set the webhook URL as an environment variable:

```bash
SLACK_FEEDBACK_WEBHOOK=https://hooks.slack.com/services/...
```

The Slack adapter reads from `SLACK_FEEDBACK_WEBHOOK` by default. You can also pass it explicitly:

```ts twoslash [vocs.config.ts]
import { defineConfig, Feedback } from 'vocs/config'

export default defineConfig({
  feedback: Feedback.slack({
    webhookUrl: process.env.MY_CUSTOM_WEBHOOK
  })
})
```

### Feedback Format

When a user submits feedback, Slack receives a formatted message with:

* **Sentiment**: Positive (👍) or negative (👎)
* **Page URL**: The page where feedback was submitted
* **Category**: What the user liked or what went wrong
* **Message**: Optional free-form message from the user

## Custom Adapter

Create a custom adapter for other destinations:

```ts [vocs.config.ts]
import { defineConfig, Feedback } from 'vocs/config'

export default defineConfig({
  feedback: Feedback.from({
    type: 'custom',
    async submit(data) {
      // data.helpful: boolean
      // data.category?: string
      // data.message?: string
      // data.pageUrl: string
      // data.timestamp: string (ISO format)
      
      await fetch('https://your-api.com/feedback', {
        method: 'POST',
        body: JSON.stringify(data)
      })
    }
  })
})
```

## Disabling Feedback

To disable the feedback widget globally, omit the `feedback` option from your config or set it to `undefined`.

To disable the feedback widget on a specific page, use the `showFeedback` frontmatter option:

```mdx
---
showFeedback: false
---

# Page Title

This page won't show the feedback widget.
```