> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sitespy.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications

> Get notified when your watched pages change

Site Spy can notify you through multiple channels when changes are detected.

## Browser notifications

Desktop push notifications appear even when the extension popup is closed. They are **off by default** — nothing is shown until you turn them on.

1. Open the extension popup and go to **Settings**
2. Expand the **Browser Notifications** section
3. Enable notifications using the toggle
4. Click **Send Test Notification** to verify they work

**Show badge count** is a separate toggle in the same section, also off by default. Turn it on if you want the unviewed-change count on the extension icon.

The extension only polls for changes in the background while notifications or the badge are enabled. **Background check interval** in the same section controls how often it does so — 1 to 60 minutes, 5 by default. This is local polling; the server checks your pages on its own schedule regardless.

### Was that change useful?

Every change notification carries two buttons, **Useful** and **Noise**. They tell Site Spy whether that kind of change is worth alerting you about. The same pair appears on the diff page.

Marking a change as noise offers to retune the watch's filters so similar changes stop notifying you. It is the fastest way to quieten a noisy watch without writing selectors by hand.

### Troubleshooting

If test notifications don't appear:

* **Chrome**: Check `chrome://settings/content/notifications` — make sure the browser is allowed to send notifications
* **Firefox**: Check `about:preferences#privacy` under Permissions > Notifications
* **macOS**: Go to System Settings > Notifications and ensure your browser is allowed
* **Windows**: Go to Settings > System > Notifications and check your browser

## Email notifications

Email notifications are available on all plans, including Free.

1. Go to the [web dashboard notifications page](https://sitespy.app/dashboard/notifications)
2. Click **Enable Notifications** in the Email section
3. A verification email is sent to your account email
4. Click the verification link in the email
5. Once verified, you'll receive emails when watched pages change

You can send a test email to confirm delivery after verification.

## Telegram notifications

Connect a Telegram bot to receive change alerts in Telegram.

1. Go to the [web dashboard notifications page](https://sitespy.app/dashboard/notifications)
2. Find the Telegram section
3. Click **Connect Telegram**
4. Click **Open in Telegram** to start the bot
5. Tap **Start** in the Telegram chat

Once connected, you can send a test message and disconnect at any time.

## How often notifications can arrive

Each watch is limited to 4 notifications per hour and 24 per day, across all channels. Changes above that are counted rather than sent, and the next notification tells you how many were held back. See [Email Notifications](/docs/dashboard/email-notifications#how-many-emails-you-can-get).

## Alerts when a watch breaks

The same channels also carry health alerts: if a watched page starts blocking our checks, disappears, or your filter stops matching, Site Spy emails the watch owner instead of failing silently. These alerts are sent on every plan, including Free. See [Watch Health & Failure Alerts](/docs/dashboard/watch-health).