Skip to main content

Create and edit an event

What this page is — the event form: the fields every event has, the fields your calendar's template adds, and how to reschedule.

What it is for — booking time, and recording the details that make the booking useful to whoever turns up to it.

The problem it solves — the lower half of this form is different on every calendar, because it comes from the template. This page explains which half is which.

Route: /org/orbits → a calendar → Add Event, or click an existing event Permission to create: Shows "Add Event" button; enables dateClick. Permission to change: Enables Drag-and-Drop (editable={true}); shows "Update" in modal. Permission to delete: Shows "Delete" button in Event Modal.

Figure 1 — The top of the event form.

1. The two halves of the form​

Where it comes fromThe same on every calendar?
Title, dates, times, All Day, Assign To, ParticipantsThe productYes
Everything under Additional DetailsThe calendar's templateNo

2. Field reference — the fixed half​

FieldTypeRequiredHolds
Event TitleTextYesWhat the event is called. Shown on the grid
Start Date / End DateDate pickerYesThe day, in the calendar's timezone
Start Time / End TimeTime pickerYes, unless all-dayThe times, in the calendar's timezone
All Day EventSwitchNoRemoves the times and spans the whole day
Assign ToPickerNoWhich resource is doing this. Only resources allocated to the calendar are offered — see calendar resources
ParticipantsPickerNoWho is invited — see event participants

The default length of a new event comes from the calendar's default duration.


3. Field reference — the template half​

Figure 2 — Template-defined fields under Additional Details.

The fields under Additional Details are defined by the calendar's template, so they differ from one calendar to the next. On a site-visit calendar they are:

PipFieldTypeRequired
1Event Title (fixed half — shown for orientation)TextYes
2Phone NumberTextYes
3Interested Unit/PlotTextYes
—Client NameTextYes
—Visit TypeDropdown — First Visit, Negotiation, Final InspectionNo
—Cab Pickup Required?Yes / noNo

On an interview calendar the same section asks for Candidate Name, Position, Round, Resume / CV Link and a meeting link instead. See calendar templates.


4. Step by step​

  1. Open the calendar and click Add Event, or click a date on the grid.
  2. Give the event a title, and set its start and end.
  3. Choose the resource under Assign To, and check the availability panel below it.
  4. Fill in the template's fields under Additional Details.
  5. Add participants if anyone needs inviting.
  6. Save Event.

5. Rescheduling​

Drag an event to a new time on the grid, or open it and change the dates. Both need Enables Drag-and-Drop (editable={true}); shows "Update" in modal.

Changing an event that has participants sends them an update, if the calendar has a connection set — see event notifications.


6. Checking availability before you save​

Once a resource is assigned, the form lists that resource's other events for the same day and flags overlaps. It does not prevent you saving. Its limits are covered in calendar resources.


7. Don't confuse this with…​

Assign To vs ParticipantsAssign To is the person doing the work, and must be a calendar resource. Participants are invited guests, and are contacts
Deleting vs deactivatingDeleting removes the event. Deactivating applies to a whole calendar, not an event

8. Troubleshooting​

SymptomCause
No Add Event buttonYou lack the create permission, or the calendar is inactive
Dragging does nothingYou lack the edit permission
A required field you cannot fillThe template requires it. See calendar templates
Nobody to assignNo resources are allocated to the calendar
The time saved is not the time you meantCheck the calendar's timezone — see getting started

More in troubleshooting.