Skip to main content

​
Step 1 — Open workspace permissions

Head to Settings → Permissions from the sidebar. You’ll land on a split view that includes Roles, Users, and Group Sync controls.
Changes in this view auto-save. Use the Refresh action if you need to confirm a role update visually.

​
Step 2 — Create or sync roles

  1. Click Check group roles to refresh the roster from your linked Roblox groups.
  2. Select Add Role to define a new permission set.
  3. Expand the role to set the name, color, and granular permissions.
  4. Optionally link the role to a Roblox group rank so assignments happen automatically.
Keep roles scoped by function (e.g., Support, Moderator, Admin) and grant the minimum needed permissions for each.

​
Step 3 — Assign roles to collaborators

  • Use the Users tab search box to find teammates by their full Roblox username or user ID.
  • Open the dropdown next to their row and pick the desired role. Changes apply instantly.
  • Remove a user by choosing Remove from the same dropdown.
Removing a user instantly revokes access. If you just need temporary limits, assign them to a low-privilege role instead of deleting.

​
Step 4 — Enable group-synced automation

  1. Under Group-synced Roles, match Roblox group ranks to Orbit roles in the drop-down selectors.
  2. Click Check group ranks when the Roblox API changes so the latest ranks appear.
  3. Orbit now assigns users based on their Roblox group rank and your configured mapping.

​
Common helpers

  • Role audit tip: Export the role list before making sweeping permission changes so you can revert if needed.
  • API integration: Use the /members API to pull current role assignments for reporting or sync with other systems.
  • Errors? See Common Errors & Fixes for rate limits, authorization issues, and deployment tips.

​
Getting support

  • Planetary Cloud: Use the live chat widget on the dashboard for immediate help.
  • Self-hosted: Share logs and steps in Discord under the support forum thread. Include X-Request-ID headers when reporting API issues for faster triage.
Add admins to a monitoring role that receives alerts for user removals, so you can re-invite accidentally removed teammates quickly.

​
Next steps

Invite members

Bring in new collaborators and assign them to the right roles.

Configure feature flags

Decide which features (Sessions, Documents, Alliances) are available per workspace.

Members API

Use the API to export role assignments or integrate with external systems.