Skip to main content

Connections

Connections are the Connections group on the channel side of the settings window. Open Settings in the dashboard sidebar, select the channel at the top left, and choose an area under Connections. The short link /dashboard/settings/channel/connections opens the Overview; each platform has its own area, for example /dashboard/settings/channel/connections/twitch. The window opens over the page you are on. Areas appear only for the platforms, features and permissions available to your account. Existing bookmarks to the former Connections hub redirect permanently to the matching short link and keep their query.

Find your connection​

AreaShort linkWhat you can manage
Overview/dashboard/settings/channel/connectionsConnections needing attention, platform status and connected services
Twitch, YouTube, Kick/dashboard/settings/channel/connections/twitch, …/youtube, …/kickThe channel, its permissions, its chat bot and its OAuth app
Spotify/dashboard/settings/channel/connections/spotifyMusic connection, permissions and your Spotify app
Discord/dashboard/settings/channel/connections/discordServers using the Lumio bot
Services/dashboard/settings/channel/connections/servicesOBS, StreamElements and Shopify

The Overview shows Needs attention when a channel or bot needs reconnecting, a required permission is missing, an own app cannot be read, a Discord server needs attention or Spotify authorization is nearing its end. Choose the action on that row to fix it or to open the platform's area. In the window's list, the Overview entry counts every outstanding item and each platform entry counts its own: red when something is disconnected or broken, amber for a warning or a missing permission. While anything needs attention, Settings in the dashboard sidebar carries a dot, and Reconnect in a dashboard alert opens the platform's area in the window. Login connections used to sign in to Lumio remain under Security → Sign-in.

Above the table a legend says what the columns Channel, Bot, App and Permissions mean. The table lists each platform with its channel, bot, app and permission state and the action its state needs. It fits the window and never scrolls sideways. Where the space is tighter, it becomes more compact: the YouTube badge shows only its flask icon, and Open and Rejoin all bots show only their icons, with the full name on hover and for screen readers. Where the space is narrower still, as on a phone, every platform becomes a card with the same states as labelled lines and the action button underneath. A value too long for its column ends in …; hover over it to see the full text.

You can open the group if at least one area is available to you. A platform's channel sections need connections:read and the Connections feature; its chat bot needs bot-connections:read and the Bots feature. OBS needs obs:read, StreamElements needs se-tokens:read, and Shopify needs connections:read, each with its corresponding feature (Shopify: the Shopify integration on your plan). A direct link to an area you cannot access shows no access instead of its data.

Under What Lumio may do, every permission the platform granted is listed with one sentence on what Lumio uses it for. A missing permission is marked missing. Before a Twitch or Kick channel is connected, What Lumio can do with it sums up what connecting gives you instead. The channel connection reads the chat, events and moderation actions; writing and moderating in the Lumio chat use each member's own Twitch, Kick or Google sign-in. The connections page says so under What Lumio may do (or under What Lumio can do with it before connecting), and the connect dialog points it out too.

For Twitch, AutoMod held messages says Lumio can show messages held for review in the chat; allowing and denying use the acting member's own Twitch sign-in. Blocked terms and AutoMod level says Lumio requests these rights together so you need only one reconnect, but does not use them yet. Manage terms and the level on twitch.tv. If the channel was connected before these rights were requested, use Grant permission to reconnect it once.

Connect a channel​

  1. Open the platform's area and check the Channel and App sections. Twitch and Kick normally use Lumio's app. YouTube and Spotify require your account's own OAuth app.
  2. If App asks for setup, select Set up app and finish the guided steps below. Your client ID and secret are stored encrypted for this Lumio account.
  3. Select Connect in the Channel section. Review the permissions in the dialog, then authorize on the platform's site.
  4. You return to the same platform area. A toast reports the result and the channel row shows its connection state.

While YouTube or Spotify is not connected, its area shows these as two steps. Step 1 states whether an own app is stored:

  • No app stored: Step 1 offers Set up now. Connect in step 2 stays disabled and shows Step 1 first.
  • App stored: Step 1 is ticked as Own … app set up and shows the client ID's last four characters and the date it was saved. Change opens the guide to replace an app that does not fit. Connect is enabled. Removing the app is available in the App section after connecting.
  • Stored app can no longer be read: Step 1 is highlighted as a warning with Re-enter. Connect stays disabled until you have entered the keys again.

A channel reconnect must authorize the same platform account. If you sign in as a different one, Lumio keeps the existing channel and shows which account is required. When a required scope is missing, Grant permission starts the same connect flow. You do not need to disconnect first. YouTube's optional Analytics revenue scope can be declined while the channel remains connected; it never creates a standing missing-permission warning. Your personal Twitch sign-in can also lack a right Lumio asks for, such as moderator:manage:automod for Allow and Deny. If you hold an affected chat permission, an amber Twitch sign-in needs a new permission notice in Chat and the dashboard offers Sign in with Twitch again; the Chat page also shows it above the input. The notice does not appear when Lumio does not know the old grant's scopes or in a popout, and a disconnected sign-in shows its disconnect notice instead. Members with history:revenue-read can see YouTube amounts in Stream History.

Set up your own Spotify app​

The Spotify area opens a five-step full-screen guide. Each step shows where to work in Spotify's developer dashboard:

  1. Account & Premium: check that the Spotify account you intend to connect has Premium.
  2. Create the app: register Lumio's callback address and select the Web API and Web Playback SDK.
  3. Allow your account: add the connecting account's email under User Management while the app is in Development Mode. Spotify allows up to five users there. If the account is missing, Lumio saves no connection and its message points you to this step.
  4. Copy the keys: copy the client ID and client secret from the app.
  5. Enter the keys: save them in Lumio, then connect with the same Spotify account.

Spotify authorization ends 180 days after consent, even if access tokens refresh in between. The Spotify area shows the authorization end date; the Overview asks you to reconnect during the last 14 days. Reconnect starts a new 180-day period and keeps your app and keys.

Set up your own YouTube app​

The YouTube area opens a six-step full-screen guide for a Google Cloud web application:

  1. Project & API: create a project, enable YouTube Data API v3 and, if you want YouTube revenue figures, enable YouTube Analytics API.
  2. Create the app: configure Google Auth Platform with an external audience.
  3. Branding: enter the website, privacy and terms addresses shown by Lumio.
  4. Scopes & publish: register the two required YouTube scopes and the optional Analytics monetary scope, then move the app to In production. An app left in Google's Testing status can issue refresh tokens that end after seven days.
  5. OAuth client: create a web client, register the callback address and download its client JSON.
  6. Enter the keys: drop the JSON file into Lumio. Lumio checks the web-client type and callback address in your browser before saving the ID and secret; manual entry is also available.

The callback address and scopes shown in each guide come from the current connection settings. Copy those values into the provider console exactly. See OAuth provider setup for provider details.

On a phone, each guide keeps Back and the step's button in one bar at the bottom, long addresses wrap instead of running off the screen, and the console sketch opens with Show sketch.

Twitch asks for channel:manage:raids so a viewer with the Lumio chat:raid permission can cancel a running raid from the card above chat, including in a popout. Lumio does not start raids. The connection explains this under Cancel running raids.

Reconnect or disconnect​

A short-lived access-token expiry is informational because Lumio refreshes access tokens automatically. A Reconnect required state means the provider has rejected the grant. Reconnect from the relevant platform area. For Google Testing and Spotify's 180-day limit, the area can explain the specific cause.

Open the Channel row's menu and choose Disconnect to see what will be removed. Confirming stops that platform's worker and removes the connection with its tokens. Disconnecting YouTube also removes its associated revenue data, so only YouTube's dialog lists something under Will be deleted; Twitch, Kick and Spotify list only what stays. Your channel's data stays: chatter profiles, moderator notes, the moderation and AutoMod logs, chat history and events remain and are deleted only when their retention period ends or when you dissolve the channel. Stream reports have no retention period: they stay until you dissolve the channel. If you connect the platform again, you see them again. Your own OAuth app and its saved credentials remain, so you can connect again. Deleting an own app can also disconnect a channel that depends on those credentials.

Chat bots and Discord​

The Chat bot section on each Twitch, YouTube and Kick area shows whether the bot is in chat, paused, offline or disconnected. You can pause or resume it, ask it to re-enter chat, and connect your own bot identity when that feature is available. Re-enter chat asks a working bot to join again; Reconnect bot renews an OAuth grant. Use a bot account distinct from the channel account. Disconnecting an own bot returns the platform to its Lumio bot where available. Bot actions require bot-connections:create; removing an own bot requires bot-connections:delete.

In the Discord area, Add server invites the Lumio bot. You need Manage Server in Discord. Each linked server shows Connected, Bot removed or Permissions missing. A server with live notifications switched on also names the channel they post to. Reconnect repeats the verified invite; Disconnect removes the server mapping and its settings and makes the bot leave. Discord sign-in belongs under Security → Sign-in and cannot be assigned as a channel connection.

Services​

The Services area shows OBS and StreamElements independently, according to your permissions and plan. OBS can be configured for local or remote WebSocket access; Test checks the connection and reports the result on the row. StreamElements holds encrypted tokens for tip ingestion, with a platform and optional label for each token. Streamer.bot appears as later-service information rather than a setup control.

Shopify​

Lumio receives your Shopify store's orders as events. You cannot type a store address into Lumio: the connection always starts in your Shopify admin.

  1. In Services › Shopify, select Shopify App Store (when the server has no App Store listing yet, the row says so) and install Lumio on your store.
  2. In your Shopify admin, open Apps › Lumio and select Connect Lumio account. Shopify opens a Lumio tab.
  3. The Lumio tab names the store by its myshopify.com address and shows the Lumio account it will go to. The warning above Confirm connection uses that address only, not a store display name. Pick another account in the list if needed; accounts where you may not create connections are shown but cannot be picked. Confirm only if you started the connection yourself in your Shopify admin. You need connections:create, and Shopify must be part of the account's plan. If you are not signed in, Lumio asks you to sign in first and then shows the same page again.
  4. Switch back to Shopify. It asks once more whether the store should be connected to that Lumio account; confirm there to finish.

A link from Shopify is valid for 10 minutes and only once. An expired or used link says so; start again in your Shopify admin. One store belongs to one Lumio account, and one account connects one store; if the store or the account is already taken, the confirm page says so and what to do.

Once connected, the row shows the store name, its myshopify.com address and the date it was connected. Open in Shopify opens Lumio in your store's Shopify admin. Expired means Shopify no longer accepts Lumio's access; open Lumio in your Shopify admin (Open in Shopify) and Shopify renews it.

Buyer name on stream sets how order events name the buyer: no name (default), initial (A.), first name (Alex), first name and initial (Alex M.), or the buyer's own name (a name the buyer types in the cart for the stream). A name appears only when the buyer agreed in the cart or checkout or typed a name; you set up that block in Shopify (Open in Shopify › Setup). For the three real-name forms, Lumio also needs Shopify's approval for protected customer data (level 2). It applies to orders that arrive afterwards. Changing it needs connections:edit.

Place Name on livestream on the cart page of an Online Store 2.0 theme. Shopify Plus stores can also place Lumio's checkout block. The real-name forms show an unticked checkbox; Your own name shows an optional text field. If a buyer uses accelerated checkout without seeing an eligible block, no buyer name reaches Lumio. The embedded Shopify page shows setup steps and the shop's privacy-policy status.

Order details on stream has two switches: Show items (item name and quantity, on by default) and Show price (order total with currency and, with items shown, each item's price; off by default, hidden in streamer mode). Whatever is switched off, Lumio does not store at all. They apply to new orders and need connections:edit.

Automations can read {{event.raw.line_items}} only when Show items was on for that order, and {{event.raw.total_price}} only when Show price was on. Older events keep the details they had when received.

Disconnect (in the row's ⋯ menu, connections:delete) asks for confirmation, then stops accepting the orders and deletes Lumio's access. Shopify keeps sending orders until you remove Lumio in your Shopify admin; Lumio discards them unread.

In the Events feed an order shows the buyer name (as plain text, never a user card), up to three items (2× Hoodie, then +2 more) and the total, as far as your settings allow. Hide name (the eye icon on an order with a name, events:edit) removes the name from that order and from its Order Paid event after a confirmation. What was already shown on stream is not recalled. The chat shows the same order line without the action.

See also​