Getting Started

Setting up your Twitch Youblicity account.

Account Setup
  1. Sign in to Youblicity using your Twitch account.
  2. Start and create a . setup_browser_source

Sign in

The next step should be done when the Stream is offline or when the overlay is moved off stream in OBS. You won't have to do this every stream, you will stay logged in!

  1. Add your URL to the BrowserSource
browser_source

Authentication

Because we use advanced authentication to protect your overlay and chat from unauthorized access, your OBS Browser Source needs to be authorized with your Youblicity account. You can do this either directly from your Youblicity Dashboard (ideal for remote streaming servers without an interactable Browser Source) or via the OBS "Interact" window.

Option 1: Approve from Dashboard (Recommended & Remote Server Friendly)

  1. Copy your stream URL from your and paste it into your OBS Browser Source (or remote streaming server). Because ?setup=true is unchecked by default, the overlay stays completely blank while waiting for approval.
  2. Stay on your Youblicity page—within a few seconds, a Pending Browser Source Approval notice will appear.
  3. Click Approve to authorize the connection. Your Browser Source will authenticate automatically and connect to your overlay!
browser_source_approval

Make sure you only have the overlay active in one place at a time (e.g., remove it from your local OBS if you move it to a remote streaming server). Multiple active overlays will prevent ads from displaying.

Option 2: Interactive Login inside OBS (via Setup Parameter)

  1. Right-click your Browser Source and go to Properties.
  2. Append ?setup=true to the end of the URL (e.g. .../stream/1234?setup=true).
  3. Press "Interact" to login, you should be redirected to your BrowserSource again after logging in.
browser_source_interact

CRITICAL: If you used ?setup=true, remove ?setup=true from the URL when you're done. If you leave it on, and your session is ever revoked for any reason while you're live, your overlay will redirect to the login screen and show it to your viewers!

  1. Done! Once authorized, everything is connected and set up.

  2. You can now start your stream and participate in Campaigns!

Twitch Permissions

To use all of its features, Youblicity needs certain permissions from your Twitch account, specifically for managing chat and tracking your Guest Star sessions.

You can check the status of your permissions at any time in your . If you see an "Action Required" notice, click the update button to grant access.

A close-up of the permissions list with a missing permissions

Guest Star Tracking

To enable automatic tracking of your sessions, please ensure the "View Guest Star" permission is granted.

A close-up of the permissions list with all permissions

Troubleshooting

OBS Login & Authentication

If your overlay is blank or you've been logged out, you need to re-authenticate your OBS Browser Source.

Please refer to the authentication methods in the section above to securely log back in without showing a login screen on your stream.