Creating Groups
Last updated: 2026-05-20
You can create a group two ways: from scratch via the four-step wizard, or pre-filled from a template.
Permissions — needs
group:createin the current workspace. The "Create Group" actions are hidden when you lack this permission.
Creating a Group from Scratch
Navigate to /groups/create (alias: /groups/new). You'll land in a four-step wizard.
Step 1 — Basic Info
- Group Name (required) — must be unique within your workspace.
- Slug — auto-generated from the name; click to edit if you need a custom URL slug.
- Description — optional.
- Group Type — pick one of:
TEAM,SECURITY_GROUP,RESOURCE_COLLECTION,AUDIENCE,CHANNEL_GROUP,BETA_PROGRAM,DYNAMIC_AUDIENCE,FEATURE_FLAG_GROUP,PROJECT_GROUP, orCUSTOM. - Icon / Color — optional, used in cards and lists.
Step 2 — Membership
- Membership Type —
STATIC(manual),DYNAMIC(rule-based) orHYBRID(both). If you pickDYNAMICorHYBRID, you'll configure rules separately after creation — see dynamic groups. - Composition Mode —
HOMOGENEOUS(one entity type only) orHETEROGENEOUS(mixed). - Allowed Entity Types — pick any combination of
User,App,File,VibeDeck,Resource,Group. ForHOMOGENEOUSgroups you must pick exactly one. - Allow Member Invites — whether members can invite others.
- Require Approval to Join — whether join requests need admin approval.
Step 3 — Settings
- Visibility —
PRIVATE,INTERNAL,PUBLIC_LINK, orDIRECTORY_LISTED. - Scope — usually
WORKSPACE; only platform admins should change this. - Max Members — optional cap; leave empty for unlimited.
- Allow Nested Groups — toggle to allow this group to have child groups (see hierarchy).
- Max Nesting Depth — depth limit when nesting is allowed (default 5).
- Metadata — optional free-form JSON for downstream consumers.
- Tags — optional key/value tags (Marqueue universal entity tags).
Step 4 — Review
Cross-check the summary panel, then click Create Group.
Tip — the wizard saves a local draft as you type. If you close the tab and come back, your in-progress group is restored. Drafts opened from a template are stored separately from manual drafts, so they don't overwrite each other.
Creating a Group from a Template
Templates pre-fill every wizard step from a saved configuration.
- Open
/groups/templates(admin shell) or click a template card from the Templates tab on the Groups landing page. - Click a template to open its detail page, then click Use Template — or click Use directly on the card.
- You're routed to
/groups/new/template/:templateId. The wizard opens with:
- A banner showing the template name at the top
- All four steps prefilled from the template
- The Group Name field cleared — you must provide a unique name
- Adjust any field, then submit.
See templates for managing the template catalog.
What Happens After Creation?
- The group is created in ACTIVE status (or DRAFT if your tenant policy requires admin activation).
- You become the OWNER of the group automatically. An entry is recorded in the group's activity feed (
GROUP_CREATED). - The group is registered as an RBAC resource so it can be granted workspace-level permissions.
- You're navigated to
/groups/:groupId(Overview tab). From there you can add members, configure hierarchy, and tweak settings.
If the groups-created usage quota for your tenant is exhausted, group creation fails with a quota error — see your billing administrator.
Cancelling
Clicking Cancel in the wizard prompts a confirmation dialog before discarding your draft. If you confirm, the local draft is cleared.