Admin Groups

The owners-only Groups page - each Roblox group with its one Open Cloud key, and how to add, check, replace and remove them.

Panel / Admin pages

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 RobloxPermissionRequiredWhat it is for
groupsgroup:readyesChecking the key against the group
universeuniverse:readyesReading the group's games, private ones included, to register them
universe-analyticsuniverse.analytics:readnoPlayers, visits, retention, revenue and the rest of the analytics
developer-productsdeveloper-product:readnoEach developer product and its price
game-passesgame-pass:readnoEach game pass and its price
user-restrictionsuniverse.user-restriction:readnoWho 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

  1. Open Add group

    On Admin, Groups, choose Add group. The dialog has two steps.

  2. 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.

  3. Create the key

    Press Create API Key and name it after the panel, such as "Blockout panel".

  4. 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.

  5. 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.

  6. Generate and copy

    Press Save & Generate Key and copy it. Roblox shows it only once.

  7. 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

  1. Check it

    On Admin, Groups, choose Check on the group's card.

  2. 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

  1. Create the new key on Roblox

    Follow the same steps as for adding a group.

  2. Replace it in the panel

    Choose Replace key on the group's card, paste the new key, then Replace and check.

  3. 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

  1. Remove it here

    Choose Remove on the group's card, then Remove group in the confirmation.

  2. 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