The Groups page (/admin/groups) lists the Roblox groups the studio publishes under, each with its one read-only Open Cloud key. Only organization owners can open it. Why each group has exactly one key, and what the key is used for, is on Roblox groups and keys.
Groups page tiles
- Keys workinggroups
The accent tile: groups whose key passed its last check, "of" all groups.
- Groupsgroups
How many groups are registered, one key each.
- Games coveredgames
Studio games whose group has a registered key, "of" all studio games.
- Analytics readinggames
Studio games whose last daily analytics read worked.
The last two come from the same read as Integrations. When that read fails, they show a dash and "Could not be read"; the groups below still show.
What a group's card shows
One card per group, sorted by name, two to a row on a wide screen and one on a phone:
- The group
Its icon, name, id and member count.
- The key's state
A badge: what Roblox said the last time the key was checked (below).
- What the key may read
One chip per permission the studio uses, each marked as reaching every game, some games only, or missing (dashed).
- The key line
"key" and its fingerprint, who stored it, and the last check's sentence with how long ago (or "Never checked").
- Buttons
Check, Replace key and Remove.
How the key then reaches each of the group's games, every day: How a group key reaches a game's analytics.
The key's fingerprint
The panel never shows a key, to anyone, owners included. The fingerprint is the first sixteen characters of a SHA-256 hash of the key: enough to tell two keys apart, not enough to get the key back or confirm a guess. Members never see a key or its fingerprint.
The key itself is sealed (encrypted) at rest with the platform's credential root key, bound to its own row so a sealed value copied onto another row does not open. Only the worker opens it, for the daily read; if the worker has no root key (CREDENTIALS_ROOT_KEY), every covered game reads Read failed with "The worker cannot open stored keys".
What Key refused, Not permitted and the other key states mean
The badge on a group's card is the result of the key's last check:
- Working
Roblox accepted the key and it holds the two required permissions. Missing optional ones are listed.
- Key refused
Roblox did not accept the key, or it is disabled or has expired on Roblox.
- Not permitted
A required permission is missing, the key may not read this group, or Roblox refused this server's address.
- Not found
Roblox shows no such group to this key.
- Check failed
Roblox could not be reached: try again in a minute.
- Not checked
The key has never been checked.
The sentence beside the fingerprint says exactly what to fix, for example "Works. Missing game-passes." or "The key lacks universe with universe:read: add it on Roblox". A key that reaches only some games says "... reaches only some games: turn off Restrict by Experience."
The permissions a group key needs
All are read-only: a leaked key could see analytics but change nothing.
| On Roblox | Permission | Required | What it is for |
|---|---|---|---|
groups | group:read | yes | Checking the key against the group |
universe | universe:read | yes | Reading the group's games, private ones included, to register them |
universe-analytics | universe.analytics:read | no | Players, visits, retention, revenue and the rest of the analytics |
developer-products | developer-product:read | no | Each developer product and its price |
game-passes | game-pass:read | no | Each game pass and its price |
user-restrictions | universe.user-restriction:read | no | Who is banned from each game and why |
A key without a required permission is refused. A key without an optional one is stored and works, and what it cannot read shows as missing.
How to add a group
Open Add group
On Admin, Groups, choose Add group. The dialog has two steps.
Open the Creator Dashboard
Choose Open the Creator Dashboard, signed in as the studio's holder account, and pick the group at the top. One key per group: it reaches every game the group owns, private ones included.
Create the key
Press Create API Key and name it after the panel, such as "Blockout panel".
Add the permissions
Under Access Permissions, add each API system in the table above with its operation. Leave the switch beside each system off: it is Restrict by Experience, and off means the key covers every game of the group, new ones included.
Security settings
Leave the IP restriction off unless the panel's server has a fixed public address. Keep No Expiration: Roblox expires a key after 60 days unused, and the daily read keeps it in use.
Generate and copy
Press Save & Generate Key and copy it. Roblox shows it only once.
Paste it here
Choose I have the key, enter the Group id (the number in the group's address on roblox.com) and the API key, then Add and check.
Roblox is asked at once what the key may do and whether it reads the group. If anything required fails, nothing is stored and the dialog says why ("The key was not stored."). A group that is already registered is refused: replace its key instead.
How to check a group key
Check it
On Admin, Groups, choose Check on the group's card.
Read the result
The badge, the permission chips and the sentence update, and a message at the top repeats the result. Fix what the sentence names on the Creator Dashboard, then check again.
A check asks Roblox to describe the key, reads the group with it, and reads the group's public profile. It stores whatever it finds, even a failure.
How to replace or rotate a group key
Create the new key on Roblox
Follow the same steps as for adding a group.
Replace it in the panel
Choose Replace key on the group's card, paste the new key, then Replace and check.
Revoke the old key on Roblox
The new key is stored only once it passes the checks. Then revoke the old one on the Creator Dashboard.
How to remove a group
Remove it here
Choose Remove on the group's card, then Remove group in the confirmation.
Revoke it on Roblox
On the Creator Dashboard, revoke the key. The studio has deleted its copy, but the key stays valid on Roblox until you do.
Where group key changes are recorded
Every add, replace, check and removal is written to the audit log under Groups and keys, naming the owner and the group, never the key.
What a group key check costs
Adding, replacing or checking a group sends one key description request and one group read, both on the key's own Open Cloud quota, plus the group's public profile and icon. It does not touch the collector's budget.
The Groups page on a phone
The four tiles sit two to a row, and each group is one full-width card. The Add group dialog keeps its two steps; the permission list wraps.
Related: Admin Integrations, Admin pages.
Updated