Skip to main content

Group Templates

Last updated: 2026-05-20

Templates are reusable group configurations. Define a template once, and create as many groups as you like from it without re-entering every setting.

Permissions — browsing templates needs group-template:read. Creating, updating, or deleting templates needs group-template:create / update / delete. Creating a group from a template still needs group:create. In the user shell, the Templates tab is replaced with an admin-only notice — manage templates from the admin shell.


What a template captures​

A GroupTemplate stores:

  • Type, visibility, scope, and (default) membership type
  • Composition mode and allowed entity types
  • Nesting policy (allowNestedGroups, maxNestingDepth)
  • Membership policy (allowMemberInvites, requireApprovalToJoin, maxMembers)
  • Default settings, default metadata, icon and color
  • Category (free-form, used to organize the catalog)
  • A slug for stable referencing

System templates (isSystem: true) are pre-installed and cannot be edited or deleted from the UI.


Browsing templates​

Navigate to /groups/templates. You'll see a card for each template with its category, type, and a short description. From the list you can:

  • Click a card to open its detail page (/groups/templates/:templateId)
  • Click Use Template to jump straight into the create wizard
  • Select multiple templates and bulk-delete (admin only)

Creating a Group from a Template​

  1. From /groups/templates, click a template card.
  2. On its detail page, click Use Template — or use Use directly on the card.
  3. You're routed to /groups/new/template/:templateId. The create wizard opens with:
  • A banner showing the template name at the top
  • Steps 1–3 prefilled from the template
  • A unique Group Name field — required, must be unique in your workspace
  1. Adjust any field, then submit.

Groups created from a template are decoupled from it after creation — changes to the template do not propagate to existing groups.


Creating a template​

  1. Open /groups/templates.
  2. Click New Template.
  3. Fill in the form (mirrors the create-group wizard) and submit.

Each template counts against the group-templates-created quota for your tenant.


Editing or deleting a template​

  1. Open the template detail page (/groups/templates/:templateId).
  2. Click Edit to change fields, then Save.
  3. Click Delete on the detail page or hover-row on the list page; confirm.

Deleting a template does not delete groups previously created from it.


Template vs. direct creation​

FeatureDirect creationTemplate creation
Pre-filled settingsNoYes
Group nameYou chooseTemplate name shown as reference; unique group name required
Membership rulesManualPre-filled, editable
Hierarchy policyManualPre-filled, editable
Default settingsManualPre-filled, editable
DraftsStored under "manual" scopeStored per-template scope

Template Availability​

Templates are scoped to your workspace. System templates ship as part of the platform and are visible to every workspace.


See also​