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

# Group Manager

> View members, manage roles, and handle join requests for your Roblox group from the dashboard.

The Group Manager runs your Roblox group from inside Technified. Browse members, change their roles, and clear your join request queue without opening the Roblox site.

Open **Roblox > Group Manager** in the sidebar. It connects to your server's primary group through your Open Cloud key.

## Before you start

The Group Manager uses the central Open Cloud key set under **General > Games & Roblox**. The key needs the `group:read` and `group:write` scopes, and your primary group must be set.

<Warning>
  Changing roles requires a linked Roblox account. You can never assign or remove a role above your own rank in the group, so staff can only manage members below them.
</Warning>

## Overview

The Overview tab shows your group at a glance: its logo, member count, and full rank list. Each rank appears in its own role colour, the same colour you set on Roblox.

## Members

The Members tab lists everyone in the group with their Roblox avatar and current roles, shown as colour-coded chips.

### Find a member

<Steps>
  <Step title="Search">
    Enter a Roblox username, or paste a Discord ID for anyone verified in your server.
  </Step>

  <Step title="Filter by rank">
    Use the rank dropdown to show only members of a specific role across the whole group.
  </Step>

  <Step title="Page through">
    Use Prev and Next to move through the roster. Search and rank filter are separate, so picking one clears the other.
  </Step>
</Steps>

### Manage roles

Roblox lets a member hold more than one role, and the Group Manager supports that fully.

<Steps>
  <Step title="Add a role">
    Pick a role from the **Add role** dropdown next to the member. It is applied right away.
  </Step>

  <Step title="Remove a role">
    Click the **x** on a role chip to remove it. A member always keeps at least one role.
  </Step>
</Steps>

For classic single-role groups it works exactly as you would expect, with one role per member.

### Bulk actions

Update many members at once.

<Steps>
  <Step title="Select members">
    Tick the checkbox on each member, or use the select-all box to take everyone on the page you are allowed to manage.
  </Step>

  <Step title="Choose a role">
    Pick the role to apply from the bulk bar.
  </Step>

  <Step title="Add or remove">
    Click **Add** to give the role to everyone selected, or **Remove** to take it away.
  </Step>
</Steps>

You can change up to 50 members at once. If a member is skipped, for example because they outrank you, the rest still go through and the result tells you how many succeeded.

## Join requests

The Join Requests tab shows everyone waiting to join your group. Accept or decline each one with a single click, no need to switch to the Roblox group admin page.

## A note on removing members

Roblox's Open Cloud API does not currently offer a way to remove or exile a member with an API key, so the Group Manager does not include a kick action. The moment Roblox ships that capability, it will be added. Everything else, viewing, role management, and join requests, works today.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The page says no group is connected">
    Add a central Open Cloud key and set a primary group under General > Games & Roblox.
  </Accordion>

  <Accordion title="I cannot change a member's roles">
    You need a linked Roblox account and must be a member of the group. You also cannot manage anyone ranked above you, or assign a role above your own rank.
  </Accordion>

  <Accordion title="A bulk update reports failures">
    Members ranked above you are skipped, and Roblox may reject a change if your key lacks the group:write scope. The summary shows how many succeeded.
  </Accordion>

  <Accordion title="Roles or members are not loading">
    Confirm your Open Cloud key is valid and has the group:read scope, and that the primary group ID is correct.
  </Accordion>
</AccordionGroup>
