> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rbxweb.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Require Roblox authorization

> Gate roles and nicknames behind Roblox account verification.

This feature forces members to verify their Roblox account before they can fully participate. When verified, the bot assigns a chosen role and optionally renames them to their Roblox username.

Open **Dashboard → Require Roblox Authorization**.

## How it works

There are two ways a member completes verification — both end with the bot applying the verified role:

<Steps>
  <Step title="Member links on the dashboard (recommended)">
    The member opens [Roblox Authorization](/features/roblox-verification), authorizes their Roblox account, enables this server, and clicks **Save**. The verified role and nickname are applied **immediately on save** — no slash command needed.
  </Step>

  <Step title="…or runs /verify in the server">
    The member types `/verify`. If they've already linked Roblox and enabled this server, verification succeeds immediately; otherwise the bot DMs them a private link to the authorization page. This path also serves as a fallback if the bot was offline when they saved.
  </Step>
</Steps>

On success (either path) the bot assigns the configured verified role and, if enabled, updates the member's Discord nickname to match their Roblox username.

Moderators can also run `/verify-username @member` to see whether a specific member is verified and what their Roblox username is.

## Settings

### Main

<ResponseField name="Enable" type="toggle">
  Master switch for this feature.
</ResponseField>

<ResponseField name="Role to assign on verification" type="role picker">
  The role granted to members once they successfully verify. Leave blank to skip role assignment.
</ResponseField>

### Nickname sync

<ResponseField name="Change Discord nickname to Roblox username" type="toggle">
  When on, the bot overwrites the member's server nickname with their Roblox username on verification.
</ResponseField>

<ResponseField name="Append Roblox username to Discord username" type="toggle (visible when nickname sync is on)">
  Instead of replacing the nickname, append the Roblox username in parentheses with a leading space: `discord_user (roblox_user)`. If the combined length exceeds Discord's 32-character nickname limit, the Discord portion is trimmed with `…`.
</ResponseField>

<Warning>
  The bot's own role must be positioned **above** each member's highest role in **Server Settings → Roles**, or Discord blocks nickname changes.
</Warning>

### Send message on join

<ResponseField name="Enable" type="toggle">
  Master switch for the join-prompt message.
</ResponseField>

<ResponseField name="Channel" type="channel picker (required)">
  Where the verification prompt is posted every time a new member joins.
</ResponseField>

<ResponseField name="Message" type="visual editor (required)">
  The embed or plain message posted to the channel, built in the same **visual message editor** as the Welcome / Goodbye messages — type inside a live Discord preview, toggle **Embed** on/off, and use [placeholders](/placeholders) like `{user}`, `{server}`, and `{member_count}`. It comes pre-filled with a ready-made verification prompt; **Restore default** in the toolbar brings that back any time.
</ResponseField>

<ResponseField name="Assign role on join" type="role picker (single role, optional)">
  When set, the bot grants this role to every new member **before** the prompt message is posted. This is what you use when the prompt channel is gated to a specific role with view-history disabled — the member needs the role to read the message you just sent. Leave blank to skip role assignment on join.
</ResponseField>

<ResponseField name="Remove role upon Roblox verification" type="toggle (visible when a join role is set)">
  When on, the join role above is automatically stripped from the member as soon as they verify (on dashboard save or via `/verify`). Combine with the **Role to assign on verification** field at the top of the card to swap members from a "needs to verify" gate role to a verified role in one step.
</ResponseField>

<Warning>
  Role assignment and removal both require the bot to have **Manage Roles** and the bot's role must be positioned **above** the join role in **Server Settings → Roles**. Otherwise Discord blocks the change and you'll see a warning in your error reporting channel.
</Warning>

The point of this sub-feature: newcomers are told exactly how to verify without anyone needing to DM them manually — and if you gate channels to a "verifying" role, that role can be granted on join and removed on verification automatically.

## Testing

1. Save your settings.
2. With a test account, open **Roblox Authorization** on the dashboard, authorize, enable the test server, and click **Save**.
3. Confirm the test account receives the configured role and (if enabled) the nickname change **without** running any command.
4. As a fallback check, run `/verify` in a channel the bot can see — it should report the same result.