Skip to main content

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:create in 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​

  1. Group Name (required) — must be unique within your workspace.
  2. Slug — auto-generated from the name; click to edit if you need a custom URL slug.
  3. Description — optional.
  4. Group Type — pick one of: TEAM, SECURITY_GROUP, RESOURCE_COLLECTION, AUDIENCE, CHANNEL_GROUP, BETA_PROGRAM, DYNAMIC_AUDIENCE, FEATURE_FLAG_GROUP, PROJECT_GROUP, or CUSTOM.
  5. Icon / Color — optional, used in cards and lists.

Step 2 — Membership​

  1. Membership Type — STATIC (manual), DYNAMIC (rule-based) or HYBRID (both). If you pick DYNAMIC or HYBRID, you'll configure rules separately after creation — see dynamic groups.
  2. Composition Mode — HOMOGENEOUS (one entity type only) or HETEROGENEOUS (mixed).
  3. Allowed Entity Types — pick any combination of User, App, File, VibeDeck, Resource, Group. For HOMOGENEOUS groups you must pick exactly one.
  4. Allow Member Invites — whether members can invite others.
  5. Require Approval to Join — whether join requests need admin approval.

Step 3 — Settings​

  1. Visibility — PRIVATE, INTERNAL, PUBLIC_LINK, or DIRECTORY_LISTED.
  2. Scope — usually WORKSPACE; only platform admins should change this.
  3. Max Members — optional cap; leave empty for unlimited.
  4. Allow Nested Groups — toggle to allow this group to have child groups (see hierarchy).
  5. Max Nesting Depth — depth limit when nesting is allowed (default 5).
  6. Metadata — optional free-form JSON for downstream consumers.
  7. 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.

  1. Open /groups/templates (admin shell) or click a template card from the Templates tab on the Groups landing page.
  2. Click a template to open its detail page, then click Use Template — or click Use directly on the card.
  3. 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
  1. 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.


See also​