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 needsgroup-template:create/update/delete. Creating a group from a template still needsgroup: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, defaultmetadata, icon and color - Category (free-form, used to organize the catalog)
- A
slugfor 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
- From
/groups/templates, click a template card. - On its detail page, click Use Template — or use Use directly on the card.
- 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
- 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
- Open
/groups/templates. - Click New Template.
- 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
- Open the template detail page (
/groups/templates/:templateId). - Click Edit to change fields, then Save.
- 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
| Feature | Direct creation | Template creation |
|---|---|---|
| Pre-filled settings | No | Yes |
| Group name | You choose | Template name shown as reference; unique group name required |
| Membership rules | Manual | Pre-filled, editable |
| Hierarchy policy | Manual | Pre-filled, editable |
| Default settings | Manual | Pre-filled, editable |
| Drafts | Stored under "manual" scope | Stored 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.