Skip to main content

Share and embed

What this page is — publishing a calendar so people outside your organisation can book time on it.

What it is for — turning a calendar into a booking page with its own address, and putting that page on your website.

The problem it solves — arranging a demo or a viewing by email takes several messages to settle a time. A booking page settles it in one visit, against the real availability of a real person.

Route: /org/orbits → a card's Share & embed button · Permission: Edit Orbit calendar

Figure 1 — Share & embed.

1. Turning sharing on​

Sharing is off by default. Switch it on in the calendar's settings under Public Sharing & Booking — see create a calendar. Until it is on:

  • there is no Share & embed button on the card;
  • the public address returns nothing.

2. The public address​

The page lives at /public/calendar/ followed by the slug you chose. Anyone with that address can open it — there is no sign-in.

Who can reach itAnyone with the link
What they can seeThe calendar's name, its purpose text, and free times
What they cannot seeYour existing events, their titles, or who is on them

A visitor sees availability, not your diary.


3. Embedding it​

The dialog gives a snippet to paste into a web page, so the booking page appears inside your own site rather than as a link away from it.


4. What decides the times offered​

SettingEffectWhere
Available From / ToThe daily windowCreate a calendar
Working daysWhich days are offered at allSame
Resource selectionOne fixed person, or the visitor choosesSame
Existing bookingsTaken out of what is offeredAutomatic
A booking page with no resources offers nothing

Availability is calculated per resource. A calendar with no resources allocated, or set to Fixed with nobody chosen, shows a page with no times on it and no explanation. Allocate resources first — see calendar resources.


5. Field reference​

FieldTypeRequiredHolds
Public URL SlugTextYesThe last part of the address. Keep it short and stable
Booking PurposeTextNoA sentence shown under the calendar name
AppearanceLight / Dark, plus a colourNoThe page's theme
Booking identity mappingPickersGuest email requiredWhich event fields receive the visitor's email and phone
Changing the slug breaks existing links

The address is built from the slug. Anyone holding the old link — in an email, on a page, in a signature — gets nothing after you change it. Choose one and keep it.


6. Don't confuse this with…​

What the visitor seesDocumented separately, for that reader — see the public booking page
What a booking does to your dataSee what a booking creates
Page Builder's scheduling blocksThose embed booking into a designed page. This is the calendar behind them

7. Troubleshooting​

SymptomCause
No Share & embed buttonSharing is off for that calendar
The link shows an errorThe slug was changed, or sharing was switched off
The page loads but offers no timesNo resources, or the day is outside the working days — §4
The times offered look wrongSee the public booking page

More in troubleshooting.