# Stream Overlays

> How to set up alerts and overlays for your stream

- Canonical page: https://zerocut.gg/docs/embeds
- Markdown version: https://zerocut.gg/docs/embeds.md



# Stream Overlays [#stream-overlays]

Engage your viewers by showing donations and events live on your stream. ZeroCut provides "Browser Source" URLs that you can add to your broadcasting software.

## Setting Up in OBS / Streamlabs [#setting-up-in-obs--streamlabs]

1. Go to your **Dashboard > Settings > Integrations**.
2. Under **OBS Embeds**, enable embeds if they aren't already.
3. Copy the **Embed URL** for the widget you want (e.g., Donation Alert).
4. Open OBS / Streamlabs.
5. Add a new Source and select **Browser**.
6. Paste the HTTPS Embed URL into the **URL** field.
7. Set the Width and Height (recommended: 800x600 for alerts).
8. Click **OK**.

## Available Widgets [#available-widgets]

### Donation Alert [#donation-alert]

Displays a popup notification when someone donates. This is our most feature-rich widget.

#### Customization Options [#customization-options]

* **Variants**: Choose from 5 distinct styles:
  * **Simple**: Clean and minimal.
  * **GIF**: Displays a GIF for your alert. Premium users can upload a custom alert GIF or paste an HTTPS GIF URL.
  * **Banner**: A sleek, wide banner style.
  * **Party**: Festive confetti animation.
  * **Diamond**: A premium, diamond-themed look.
* **Message**: Customize the text template (e.g., "New Donation!").
* **Custom GIF**: Premium users can upload a GIF or paste any HTTPS GIF URL (external links may be reviewed).
* **Sound**: Upload your own custom MP3 or use our default sound.

#### Text-to-Speech (TTS) [#text-to-speech-tts]

Enable TTS to have donation messages read aloud on your stream.

* **Minimum Amount**: Set a minimum donation amount (e.g., $5) required to trigger TTS, preventing spam from small donations.

#### Profanity Filter [#profanity-filter]

We offer an advanced, "NSA-level" profanity filter to keep your stream safe.

* **Actions**: Choose what happens when profanity is detected:
  * **Censor**: Replaces bad words with asterisks (e.g., `****`). TTS will skip reading the censored words.
  * **Hide Message**: Completely hides the message from the alert and skips TTS reading entirely (only the amount is announced).
* **Custom Blocklist**: Add specific words you want to block that aren't in our default list.
* **Allowlist**: View the default blocklist and uncheck specific words to allow them if you don't find them offensive.

### Follower Alert [#follower-alert]

Get notified when you get a new follower.

* **Variants**: Same styles as donation alerts (Simple, GIF, Banner, Party, Diamond).
* **Sound**: Upload a custom sound for new followers.
* **GIF**: The GIF style uses the same Alert GIF configured under Donation Alert.

### Goal Bar [#goal-bar]

Shows a progress bar for your active donation goal. Great for fundraising events!

### Recent Events [#recent-events]

A scrolling list of recent donations and follows.

* **Profanity Filter**: This widget also respects your profanity filter settings, ensuring that any listed donations are censored or hidden according to your preferences.

## TikTok Live Studio [#tiktok-live-studio]

The process is similar for TikTok Live Studio:

1. Click **Add Component** > **Browser Source**.
2. Paste your ZeroCut Embed URL.
3. Adjust the size and position on your canvas.