Templates

Set up one space well, and you should never have to rebuild that setup by hand. A template packages a space's configuration so it can be applied to another space in one step — and later compared, updated, and re-extracted.

What is in a template

A template carries configuration, not data:

IncludedExamples
Roles and their panel manifestsClient, Member, with their attached extensions
Extension tables and fieldsInsurance details, Enrollments
Link types and their rulesChild of / Parent of with role rules
SettingsDefaults and tunables
Dashboards and page layoutsWidget pages and placements

Contacts, notes, files, and other records are never part of a template.

Applying a template

You need the template permission, and applying is a guarded action — you may be asked to re-enter your password.

  1. Open the Template manager from the admin menu.
  2. Pick a template and the target space, review what it contains, and click Apply.

Applying a template
The template manager: reviewing a template before applying it to a space.

Applying is safe to repeat: items that already exist and match are left untouched, so re-running an apply never duplicates anything. Everything a template creates is stamped with its origin, which is what makes the drift report below possible. Settings that came from a template show a "from template" badge, and you get a warning before overriding one locally.

Note
Applying a template never silently downgrades a local change. Where the space has customized something the template also defines, the difference is surfaced for review instead of being overwritten.

Local changes and the drift report

Spaces evolve after a template is applied. The drift report compares the space's current configuration against the template, item by item:

StatusMeaning
ChangedThe space edited an item that came from the template
RemovedThe space deleted an item the template provides
AddedThe space created an item of a template kind that is not in the template
UnchangedStill exactly as the template delivered it

A drift report
Drift between a space and its template: changed, removed, and added items.

Run the drift report before applying a template update — it tells you exactly where the space has intentionally diverged, so you can decide per item instead of guessing.

Extracting a template from a space

Built a space you are proud of? Turn it into a template:

  1. In the Template manager, choose Extract from this space.
  2. Name the template and confirm. The space's configuration is snapshotted into a new template.
  3. Apply it to the next space you set up.
Tip
Extract-then-apply is the fastest way to clone a working setup: extract from your best space, apply to the new one, then let the new space customize from there — the drift report will keep track of what they changed.

Related pages