Skip to content
Guide 07

Govee Lights

Let viewers change the colour of your Govee lights with channel points. This guide covers the key, the setup wizard, the reward, and the messages you might see.

In this guide
6 min read

01What you need

at a glanceA Govee Home account, colour lights set up in the Govee Home app, and a Twitch channel that can have channel-points rewards.
Using an AI assistant? Give it ai.itsbagelbot.com/govee/setup.md. That page is written for assistants and uses the exact button names.

You need a Govee Home account and Govee lights that are already set up in the Govee Home app. Lights that only use Bluetooth may not show up. You also need a Twitch channel that can create channel-points rewards. The dashboard's Channel points page says that Twitch only lets Affiliate and Partner channels create them. Viewers spend channel points to change the colour of your lights.

The dashboard has an "Ask your AI for help" button on each setup step. It copies a short prompt with the step you are on, so an AI assistant can read this guide and help you. Never paste your Govee API key into an AI.

02Get your Govee API key

at a glanceThe key comes from the Govee Home app and usually arrives by email.
  1. Open the Govee Home app

    Open the Govee Home app on your phone and sign in to the account that owns your lights.

  2. Go to the key form

    Go to Profile → Settings → "Apply for API Key". On some app versions it is under About us.

  3. Fill in the short form

    Fill in the short form and submit it.

  4. Wait for the email

    Govee usually sends the key by email to your Govee account address. If it does not arrive, check your spam folder, then apply again.

A new key turns off your older keys Generating a new key on your Govee account disables every other active key on that account. If another tool uses an older key, it stops working. Apply for a new key only when you need one.

03Connect the key in the dashboard

at a glanceOpen the Govee Lights page. The first time, a four-step wizard walks you through it.

Open the Govee Lights page in the dashboard. The wizard has four steps: "What you need", "Get your key", "Paste your key" and "Your lights".

  1. Start the wizard

    On "What you need", select "Let’s set up Govee".

  2. Check the path

    On "Get your key", the dashboard shows the same path as above under "In the Govee Home app". It also says: "A new key turns off any older key on your Govee account." Select "I have my key" when the email has arrived.

  3. Paste your key

    On "Paste your key", paste the key from the Govee email into the "Govee API key" field. The key is stored encrypted and never shown back.

  4. Save it

    Select "Save & continue". The dashboard checks the key with Govee first.

  5. See your lights

    On "Your lights", the dashboard shows "Colour lights found" and the number of lights. Select "Set up rewards" to continue.

Two messages can appear when you save. They mean different things:

  • "Govee did not accept this key. Check it and try again." The key was not saved. Paste it again.
  • "Key saved, but Govee did not answer, so it is not checked yet. Your lights will work once Govee is back. If they do not, paste the key again." The key is saved and you can continue.

04Create the channel-points reward

at a glanceOne reward per light. Viewers type a colour when they redeem it.
  1. Open the Govee Lights page

    Turn on "Enable Govee lights" if it is off. Under "Your lights", each light shows "Not set up" until it has a reward.

  2. Select a light

    Select the light you want viewers to control. The reward editor opens.

  3. Fill in the reward

    Set the "Reward title", the "Cost (points)", the "Tile colour" and the "Cooldown" (0 = off). The "Chat reply" field is optional.

  4. Choose what happens after it runs

    Under "After it runs", choose "Mark fulfilled", "Refund the points" or "Leave for a mod".

  5. Create it

    Select "Create reward". The bot creates the reward on Twitch. To change it later, edit the fields and select "Save changes".

What viewers type

When a viewer redeems the reward, they type a colour. A colour name in English works, like blue. A hex code works too, like #00ccff. If you turn on "Let viewers turn the light off", a viewer can type off to turn the light off.

Live only is on by default "Live only" means redemptions only work while your stream is live. This is recommended. If you turn it off, viewers can change the light even when you are offline.

05If something goes wrong

at a glanceThe messages the dashboard and the chat show for Govee lights, with what to do.

In the chat lines below, @viewer stands for the name of the viewer who redeemed the reward. Each refund line means the bot gave the points back.

What you seeWhat it meansWhat to do
"Govee did not accept this key. Check it and try again."Govee rejected the key. The key was not saved.Copy the key again from the Govee email without extra spaces. If you applied for a newer key since, use the newest one. Older keys stop working when you generate a new one.
"Key saved, but Govee did not answer, so it is not checked yet. Your lights will work once Govee is back. If they do not, paste the key again."The key is saved, but Govee did not answer when the dashboard checked it.Continue. Try the reward in a while. If the lights do not change, paste the key again.
"Could not save the key."The dashboard could not store the key.Try again in a moment.
"Govee no longer accepts this API key. Choose Remove key, then paste a new key from the Govee Home app."The key was saved earlier, but Govee now rejects it. One cause is a newer key on the same account, which turns older keys off.Select "Remove key", apply for a new key in the Govee Home app, and paste it.
"Could not load your Govee lights. Check your API key and try again."The dashboard could not get your light list from Govee. The key may be wrong, or Govee did not answer.Select "Try again". If it keeps failing, select "Remove key" and paste the key again.
"No Govee devices found on this account."Govee returned no devices for this key. The lights may not be added to this Govee account, or they may only use Bluetooth.Add your lights in the Govee Home app and connect them to Wi-Fi, then select "Refresh lights".
"No colour-capable Govee lights found on this account."Govee returned devices, but none can change colour. Only models that support colour appear.Add a colour light to your Govee account in the Govee app, then select "Refresh lights".
"Could not reach the backend. Try again in a moment."The dashboard could not reach ItsBagelBot.Reload the page in a moment.
"Reconnect to grant channel-points access."The bot needs channel-points access to create rewards on your Twitch channel.Select "Reconnect" and approve the access on Twitch.
Enter your Govee API key.The key field was empty when you saved.Paste the key from the Govee email, then select "Save & continue" again.
Enter a reward title.The Reward title field is empty.Type a title, then save the reward again.
Enter a whole number of points, at least 1.The Cost (points) is not a whole number of at least 1.Enter a whole number, 1 or more.
Enter a cooldown between 0 seconds and 7 days.The Cooldown is outside the allowed range.Enter a cooldown from 0 seconds (off) up to 7 days.
Could not toggle Govee lights.The Enable Govee lights switch did not save.Reload the page, check the switch, and try again.
Could not remove the key.The saved key could not be removed.Wait a moment and select "Remove key" again.
"Could not save the reward."The reward was not created or updated. One possible cause is a channel that is not a Twitch Affiliate or Partner, since the dashboard says Twitch only lets those channels create rewards.Check the title and cost, then try again. If it keeps failing, check that your channel is a Twitch Affiliate or Partner.
Could not delete the reward.The reward could not be deleted.Wait a moment and try again.
"@viewer the lights only change while the stream is live, your points were refunded."A viewer redeemed the reward while you were offline and "Live only" is on.Nothing. Go live, or turn off "Live only" if you want offline changes.
"@viewer that colour wasn't recognized, your points were refunded. Try a name like blue or a hex code like #00ccff."The viewer typed something that is not a known colour name or hex code.Tell the viewer to type an English colour name like blue, or a hex code like #00ccff.
"@viewer the lights are not set up yet, your points were refunded."The bot found no working Govee setup for this light when the reward was redeemed.Open the Govee Lights page. Check that "Key on file" shows and that the light has a reward.
"@viewer the lights are changing too often, your points were refunded. Try again in a moment."Too many colour changes came in at once, so the bot held this one back.Ask the viewer to try again in a moment. Add a "Cooldown" to the reward to space changes out.
"@viewer couldn't reach the lights, your points were refunded."Govee or the light did not answer.Check that the light is on and shows as online in the Govee Home app. Then try again.
Last checked: 12 October 2026.