Skip to main content

The calendar template catalogue

This is a platform-operator screen

/admin/orbittemplates is not part of a customer organisation. It is gated on View Orbit Template configuration, a platform-operator permission that a customer administrator cannot hold.

This page exists so that administrators know where templates come from, and so operators know what the screen does. If you are setting up a calendar, you want calendar templates instead.

What this page is — the catalogue of calendar templates every organisation creates calendars from.

What it is for — maintaining that catalogue: adding templates, editing their event schemas, and moving them between environments.

The problem it solves — every organisation needs a different event form. Rather than each building one, the platform ships a catalogue and organisations pick from it.

Route: /admin/orbittemplates · Permission: View Orbit Template configuration


1. What a customer administrator sees​

Figure 1 — What an organisation administrator sees at this address.

The refusal names the category, the module and the permission required, so an administrator who follows a link here can tell immediately that it is not a screen for them.


2. What the catalogue holds​

TemplatesThe list an organisation chooses from when creating a calendar
Business functionsThe groups templates are organised under — Marketing, Real Estate, HR & Recruitment, Healthcare Appointments and others
Event schemaThe fields a template's events ask for, with their types, labels and required flags
Display configurationThe view a calendar opens in, and its event colour

A template's event schema is the important part: it becomes the Additional Details section of every event on every calendar created from that template. See create and edit an event.


3. What an operator can do​

ActionPermission
View the catalogueView Orbit Template configuration
Add a templateCreate New Orbit Templates
Change oneEdit Orbit Calendar Templates
Activate or deactivate oneActivate or deactivate Orbit Templates
Import templatesImport Orbit templates
Export a template's configurationExport orbit template configuration Json
Show it in the operator menuOrbit Template Menu Listing

Export and import move a template between environments as a file, so a template built in one can be promoted to another without re-entering it.


4. Deactivating a template​

Deactivating removes a template from the picker for new calendars. Calendars already created from it keep working, and their events keep their fields — deactivation affects new choices only.


5. Changing a template that is in use​

Editing a template's event schema changes the event form on every calendar created from it, including calendars that already hold events.

Removing or renaming a field affects existing events

Events created before the change hold data against the old field. Removing a field from the schema stops it being displayed; renaming one means existing events no longer match it. Add fields freely; remove and rename with care, and check which organisations are using the template first.


6. Don't confuse this with…​

A calendar's settingsAn organisation's own timezone, working days, resources and sharing. Nothing here
Custom fields in other modulesThose are per organisation. These are platform-wide

7. Troubleshooting​

SymptomCause
Access DeniedExpected for anyone who is not a platform operator — §1
A template is missing from an organisation's pickerIt is deactivated
An organisation asks for a new fieldThe template must change, and the change affects every organisation using it — §5