Connect a Roblox group
A Linked clan takes its members from a Roblox group. You build the rank ladder in Archievery as usual and choose which Roblox role each rank gives, so a promotion here is a role change on Roblox.
What the group owns
On a Linked clan, Roblox is the source of truth for who is in the clan and who owns it. The rank ladder is yours: add, rename, reorder and delete ranks exactly as you would on a Group-less clan. Rank changes you make for a member push out to the group as they happen.
| Roblox owns | You control |
|---|---|
| Who is a member | The ranks, their names and their order |
| Who owns the clan | Which Roblox role each rank gives |
| The group's roles and their names | Permissions, XP thresholds, XP Gate and Skip in Promotion |
Binding ranks to Roblox roles
Each rank can be bound to one role in the group. A member who reaches a bound rank is given that role on Roblox, and the roles of every other bound rank are taken away. Roles no rank is bound to are never touched.
A rank you leave unbound gives the role of the nearest bound rank below it, so the ladder in Archievery can be finer than the one in the group. Guest and the owner rank are never bound: the owner rank always belongs to whoever owns the group on Roblox.
When Archievery reads the group, each member lands on the highest rank bound to a role they hold. Someone holding none of the bound roles is a Guest. The ranks page in Clan settings lists the group's roles that no rank is bound to, which is usually why.
Roblox won't let anyone give or take a role at or above their own, so the role Archievery acts through (the bot's, or yours in OAuth mode) caps which ranks it can manage. When Roblox refuses, the change is undone on both sides and the reason is shown.
Reading the sync status
The clan page shows a status strip. It matters more than it looks, because all three states serve a full member list — one of them from a copy that has stopped updating.
| State | What it means |
|---|---|
| Connected | Archievery can act on the group. Changes push through. |
| Pending | You chose bot mode and the bot hasn't been added yet. |
| Soft | Archievery can no longer authenticate with Roblox. In OAuth mode that means your authorization expired or was revoked; in bot mode, that the bot's access stopped working. |
In Pending and Soft you still see members and ranks, served from Archievery's own copy. What you can't do is push anything back to Roblox.
Joining, leaving, and ownership
All three happen on roblox.com. Join the group to join the clan; leave the group to leave it. The clan page links straight to the group rather than making you find it.
Ownership transfers the same way — hand the group to someone on Roblox and the clan follows. The dashboard's transfer control is for Group-less clans only.