Members

Lumio is built around team-managed accounts. The Members page is where you invite teammates (moderators, editors, co-hosts), change the role of existing members, and revoke invitations that are no longer needed. This guide walks through every tab, dialog, and invite method.

Where to find it

• Sidebar: Manage → Members
• URL: /dashboard/members
• Required permission to open: members:read

The page header shows the title Members and the description "Manage your team and invitations". If you have members:create, an Invite button with a user-plus icon is shown in the top-right.

Quick start

1. Click Invite in the top-right of the Members page.
2. In the wizard, pick Invite Link (default) as the method.
3. Click Next, pick the role (e.g. Moderator), click Next again.
4. Choose how long the link should be valid and how many people can redeem it (default: 7 days, 1 use).
5. Click Create Invite, copy the generated URL, and send it to your teammate.

They open the link, sign in to Lumio, and click Accept Invite — they are now a member of your account.

Tabs

The page has two tabs, each with a count badge: Members and Invites.

Members tab

Lists all current members of the account. For each member you see:

• Avatar and display name (plus a You badge if it is you).
• Email address (when available).
• Role on the right — either a coloured badge or a dropdown if you can change it.
• Joined date.
• A trash-can Remove button if you have members:delete and the member is neither the owner nor yourself.

Changing a role

If you have members:edit:

1. Click the role dropdown next to the member.
2. Pick a new role from the list. The dropdown shows each role's colour dot, name, and short description.
3. The change is saved immediately. The page refreshes to reflect the new role.

The Owner role cannot be assigned to anyone — it is reserved for the original creator of the account and appears as a static badge labelled Owner.

Removing a member

1. Click the red Remove icon to the right of the member row.
2. A confirmation dialog appears: "Are you sure you want to remove {name} from this account?"
3. Click Remove to confirm, or Cancel to abort.

Removing a member revokes their access immediately. They stay signed in to Lumio but no longer see this account in their account switcher.

The account owner's row never shows a role dropdown or a remove button — the owner cannot be changed or removed from within the UI.

Invites tab

Lists every invite ever created for the account, filterable by status. Above the list there are four filter pills with count badges:

• All — every invite.
• Pending — accepting still possible.
• Accepted — already redeemed.
• Expired — past validity, or reached max uses.

Each invite row shows:

• An icon indicating the type: link icon for shareable link/token invites, user-plus icon for direct invites.
• The label — Invite Link for anonymous invites, or the email/code/user for direct invites.
• A coloured status badge (Pending, Accepted, or Expired).
• The creator ("by {name}") and the expiry time.
• The target role, as a coloured badge.
• For pending link invites: a Copy button (with copy/check icon feedback).
• A red Trash button to revoke if you have members:delete.

Accepted and expired invites are dimmed to make pending ones easier to spot.

Invite wizard

The invite wizard is a four-step modal launched by the Invite button. The top bar shows "Step X of 4".

Step 1 — Method

Three cards side by side. Click to select.

• Invite Link (default) — "Generate a shareable link." Anyone with the link can redeem it, subject to expiry and max uses.
• Invite Token — "Generate a code to share manually." A short token the recipient types in their dashboard. Use when you cannot send a URL (voice only, on-stream).
• Invite Person — "Search by username, email, or platform." Requires the person to already have a Lumio account. A search box appears; type at least 3 characters.

For Invite Person, the search hits the global Lumio user directory and returns matching users with their display name, email (if public), and platform badges (Twitch/YouTube/Kick/Trovo/Discord). Click a result to select it; a check-mark shows which user is selected.

You cannot advance to step 2 until a method is fully chosen. For Invite Person, that means a specific user must be selected.

Step 2 — Role

A single dropdown listing every role you can assign. Each item shows the role colour, name, and description. The Owner role is excluded — a note reads "Owner role cannot be assigned."

The default selection is the first non-owner role on the account.

Step 3 — Options

Two fields side by side plus a summary card.

• Validity — dropdown with fixed choices: 1 hour, 24 hours, 7 days (default), 30 days, Never.
• Max Uses — dropdown with 1 (default), 5, 10, Unlimited. For Invite Person this field is greyed out and fixed at 1 — direct invites are always single-use.

The summary card below repeats your choices so you can sanity-check before creating: method, role, validity, max uses.

Click Create Invite to submit. Errors (for example if your plan caps the number of members) are shown inline in a red banner.

Step 4 — Result

Depending on the method, you see:

• Invite Link — a read-only URL field ({origin}/invite/{code}) with a Copy button. A short note shows the validity you picked.
• Invite Token — a monospaced token field with a Copy button and the hint "Share this token — the recipient enters it on their dashboard to join."
• Invite Person — a confirmation card with the user's avatar, name, and target role badge. A notification has been sent inside Lumio.

Click Close to dismiss the wizard. The Invites tab now shows the new invite in the Pending filter.

Accepting an invite

From the invitee's point of view:

1. They open the invite link ({origin}/invite/{code}) or enter the token on the invite-accept page.
2. The Invite Details screen shows the account name, the role they will receive, and who invited them.
3. If they are not signed in, they click Sign in to join and complete login. They are redirected back to the same invite.
4. They click Accept Invite to confirm.
5. A success screen shows "You are now a member of {account} as {role}" with a Go to Dashboard button.
6. Their active account switches automatically to the new account.

Specific failure screens are shown for expired invites, fully-used invites, invalid codes, and when the user is already a member.

Permissions

Action	Required permission
Open the Members page	members:read
Invite new members	members:create
Change a member's role	members:edit
Remove a member / revoke an invite	members:delete

Owners implicitly have all four. If you cannot see the Invite button, the role dropdown, or the delete icons, your role is missing one of these permissions — ask the account owner.

Tips and best practices

• Start with the four default roles (Owner, Administrator, Moderator, Viewer). Only create custom roles when the defaults cannot express what you need.
• Use short validity for public links. A 7-day link floating in a Discord server is a risk — a 1-hour link for onboarding a specific person is safer.
• Prefer Invite Person for long-term team. Direct invites bind to a specific Lumio user and cannot be forwarded or leaked.
• Use Invite Token for voice-only handoffs. Much easier to read over voice than a 40-character URL.
• Set max uses to match the intent. A single-use link works well for one moderator; a multi-use link for a small team. Do not default to Unlimited.
• Audit the Invites tab monthly. Revoke anything pending you do not remember creating.

Troubleshooting

Invite button is missing. You do not have members:create. Ask the account owner or someone with role-editing rights.

Role dropdown is missing but I see the member row. You have members:read but not members:edit.

Invite link says "Invite Expired" immediately after creating it. Your system clock is wrong, or the invite was created with an expiry of 1 hour while you were in a very slow network round-trip. Create a new one with a longer validity.

"Invite Full" on accept. The max_uses was reached. Ask the inviter to create a new invite or raise the limit.

"Already a Member" on accept. The invitee is already part of the account. They can switch to it from the account picker in the top bar.

Cannot find a user via Invite Person search. The search requires at least 3 characters and looks at display name, email, and connected platform identities. The user must have signed in to Lumio at least once — users who have never signed in are invisible. Use Invite Link or Invite Token instead.

Member removal does not release a plan seat. Seat counts on paid plans are recalculated nightly. Force a refresh by opening Account → Subscription and clicking the refresh icon.

Related

• Dashboard — overview of everything members can access.
• Roles and permissions — design roles that match your team's responsibilities.
• Connections — what members can manage once they have connections:* permissions.