Coming soon. The Wiki is in active development, so features and these docs may still change. Early adopters: contact us for access.

The template library

The templates every space can start pages from: the ready-made ones, your own, switching them off, and who manages them

The template library holds the templates every space offers under New page. A template is one page or a tree of pages. Spaces can switch a library template off for themselves, keep a customised copy, and have templates of their own; how that looks to space admins and writers is in the user guide's Copies and templates.

Settings → Templates: the library with each template's group, pages, last change, use in spaces and its switch
Settings → Templates: the library with each template's group, pages, last change, use in spaces and its switch

1. Who manages it

Settings → Templates needs the wiki_templates:manage permission, which super admins have. It is a permission of the installation: no space role grants it. The library is part of every licence tier.

2. Ready-made templates

A new installation, and an existing one after upgrading, gets twelve templates marked Ready-made:

TemplateGroupPages
Meeting notesMeetings1
RetrospectiveMeetings1
Weekly status reportMeetings1
Decision recordEngineering1
PostmortemEngineering1
Service runbookEngineering1
Software releaseEngineering5: the plan, test plan, release notes and rollback plan under a home page
How-to guideDocs1
Knowledge baseDocs6: getting started, how-to guides, FAQ and troubleshooting under a home page
Product requirementsProduct1
Project workspaceProduct6: scope, meeting notes, decisions, risks and status updates under a home page
Team space starterTeam7: how we work, team rituals, onboarding, tools and access, and contacts under a home page

You can change a ready-made template like any other. Reset to original puts its name, description, group, icon, content and pages back to what the Wiki ships; whether it is on stays as it is. A ready-made template can't be deleted: switch it off instead.

3. What you can do

ActionWhat it does
New templateOpens the template editor on an empty template. From an existing page makes one from a page you can edit instead, without its images, optionally with the pages under it.
The switch in the On columnOff: no space offers the template. Spaces that keep a customised copy of it keep their copy.
Edit contentOpens the template in the template editor: its pages, their content and its details.
Name, group and iconThe name, the description people see when they pick a template, the group it is listed under and its icon.
On in new spacesWhether spaces offer the template unless they decide otherwise. Off: a space admin has to switch it on in the space.
PreviewShows the template's pages and content as people see them under New page.
DuplicateAdds a copy with its content, pages, group and icon.
DeleteSpaces can no longer start pages from it. Spaces' own copies stay, and pages made from it keep their content.

The Spaces column says where each template is offered (On in all 12, Off in 2 of 12) and how many spaces keep a customised copy.

4. Limits

  • 200 templates in the library, and 100 of its own in each space.
  • 50 pages and 5 levels in one template, counting its top page.
  • Templates hold text, tables and blocks, without images or videos.

5. Audit and events

  • Every change to a template is in the audit log.
  • Templates raise events: page.template.create, page.template.update (a reset and a save in the editor too), page.template.delete, and page.template.switch when a space turns a library template on or off for itself. Policies can refuse them and automation can react.

6. API

MethodPathPermissionWhat it does
GET/api/templateswiki_templates:manageThe library
POST/api/templateswiki_templates:manageAdd a template: written (content, pages) or from a page
PUT/api/templates/{id}/contentwiki_templates:manageSave a template whole: its details, top page and every page under it
POST/api/templates/{id}/resetwiki_templates:manageReset a ready-made template to the original
GET/api/spaces/{key}/templatesRead the spaceThe templates the space offers; ?all=1 (space admins) adds the library ones it has switched off or replaced
PUT/api/spaces/{key}/templates/{id}/enabledSpace adminSwitch a library template on or off for the space
PUT/api/spaces/{key}/templates/{id}/contentSpace adminSave one of the space's templates whole

GET /api/openapi.json describes every template route with its fields.