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

# Role Bindings

> Automatically assign Discord roles based on Roblox group ranks, asset ownership, team membership, or group membership

Role Bindings are the core of Invaro's verification system. They define the rules that tell the bot which Discord roles to give when a member verifies or re-syncs their account. Invaro handles everything automatically the moment a user links their Roblox account.

***

## How Binds Work

When a user verifies their Roblox account through Invaro, the bot evaluates every active bind in your portal and applies the ones that match. If a user's account meets the condition of a bind — their group rank matches, they own a specific asset, they belong to a group, or they're assigned to a portal team — they receive the associated Discord roles automatically.

<Info>
  Higher-priority binds override nickname templates from lower-priority binds. Disabled binds are skipped entirely.
</Info>

Invaro also runs a **stale check** on load. If a role bind's stored rank name no longer matches the live rank name in your Roblox group, Invaro automatically updates the stored name and shows a notification on the card. If a rank ID no longer exists in the group at all, the bind is flagged with a warning.

There are four types of binds:

***

## Bind Types

### Role Binds

Link a specific Roblox group rank to one or more Discord roles. When a verified member holds that rank in your linked group they receive the configured roles.

**Best used for:** Syncing your Roblox group hierarchy to Discord.

### Team Binds

Assign Discord roles based on membership in a portal Team (created in the Team Directory). When a staff member is assigned to that team in the directory, they receive the configured roles on next sync.

**Best used for:** Giving department-specific roles to HR, Events, Moderation teams, and so on.

### Group Binds

Check whether a user is a member of a specific Roblox group, optionally filtered by a rank range. You can bind roles based on groups other than your primary linked group.

**Best used for:** Ally group recognition, partner communities, or multi-group setups.

### Catalog Binds

Assign roles based on Roblox asset ownership. Supported asset types: Gamepasses, Badges, Shirts, Pants, and general Assets.

**Best used for:** VIP roles for gamepass owners, donor recognition, or event badge holders.

***

## Creating a Bind

Click **Create Bind** from the Binds page. A type picker opens — choose the bind type you want to create.

### Creating a Role Bind

<Steps>
  <Step title="Select Create Bind → Role Bind">
    The modal shows your linked group's ranks. Pick the rank you want to bind by searching by name or rank ID.
  </Step>

  <Step title="Select Discord roles">
    Pick one or more Discord roles — up to 10 per bind. These are assigned when a user holds the selected Roblox rank.
  </Step>

  <Step title="Set a nickname template (optional)">
    Add a nickname template using the available variables (e.g. `{username} | {groupRole}`). Bind-level nicknames override the portal-wide global nickname.
  </Step>

  <Step title="Save">
    Click **Create Bind**. The bind is active immediately.
  </Step>
</Steps>

### Creating a Team Bind

<Steps>
  <Step title="Select Create Bind → Team Bind">
    The modal loads teams from your Team Directory.
  </Step>

  <Step title="Select a team">
    Pick the portal team this bind applies to.
  </Step>

  <Step title="Select Discord roles and save">
    Pick the Discord roles to assign, optionally set a nickname template, and click **Create Bind**.
  </Step>
</Steps>

### Creating a Group Bind

<Steps>
  <Step title="Select Create Bind → Group Bind">
    Enter a Roblox Group ID and click **Fetch** to auto-populate the group name.
  </Step>

  <Step title="Set rank range (optional)">
    Enter a **Min Rank** and/or **Max Rank** to restrict the bind to a rank range. Leave both empty to match any group member.
  </Step>

  <Step title="Select Discord roles and save">
    Pick the Discord roles to assign and optionally add a nickname template, then click **Create Bind**.
  </Step>
</Steps>

### Creating a Catalog Bind

<Steps>
  <Step title="Select Create Bind → Catalog Bind">
    Choose an asset type: Gamepass, Badge, Shirt, Pants, or Asset.
  </Step>

  <Step title="Enter the Asset ID">
    For Badges, Shirts, Pants, and Assets — paste the asset ID and click **Fetch** to auto-fill the name. For Gamepasses, auto-fetch is not available; enter the name manually.
  </Step>

  <Step title="Select Discord roles and save">
    Choose the Discord roles to assign, optionally add a nickname template, and click **Create Bind**.
  </Step>
</Steps>

***

## Managing Existing Binds

Binds are grouped by type across four tabs — Role Binds, Team Binds, Group Binds, and Catalog Binds. Each tab shows a count badge. Use the search bar to filter by name within the active tab.

Each bind card shows the bind name, type, associated Discord roles, and an optional nickname template.

| Action        | Description                                                                                                                                |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Toggle**    | Enable or disable a bind without deleting it. Disabled binds are skipped during role sync.                                                 |
| **Edit**      | Update any part of the bind — roles, rank, nickname, or enabled state.                                                                     |
| **Duplicate** | Copies the Discord roles and nickname to a new bind of the same type. You'll be prompted to enter a new rank, group ID, asset ID, or team. |
| **Delete**    | Permanently removes the bind. This cannot be undone.                                                                                       |

***

## Nickname Variables

The following variables can be used in any nickname template field:

| Variable        | Output                                    |
| --------------- | ----------------------------------------- |
| `{username}`    | User's Roblox username                    |
| `{displayName}` | User's Roblox display name                |
| `{userId}`      | User's Roblox user ID                     |
| `{groupRank}`   | Their numerical rank in your linked group |
| `{groupRole}`   | Their role name in your linked group      |

***

## Access Control

Only portal **Owners** and **Admins** can create, edit, or delete binds. Staff members with limited access roles will see an access-denied screen on the Binds page.