Truly theme developer docs Guides Reference (format 1)

Routes and states

Each page is a route with one template, templates/<route id>.liquid. A template missing from your theme falls back
to the default theme. The state says which slots the page must place: Truly checks the slot rules at upload, against
every state, and again at every render, against the state it renders. A slot counts once per placement; a consent
counts per role (consent:terms). The layout's slots count on every route: the footer once, the cookie banner once
where tracking tags may load (at most once elsewhere) and the header at most once. A container slot holds the slots
listed for it on its route, and they sit nowhere else; every other slot sits outside any container. Where a page
places both, membership_termination comes before membership_pause.

booking.locations

The booking's first step on a tenant with more than one location, choosing where to book.

Template templates/booking.locations.liquid; drops; tracking tags may load (the cookie banner is required).

Link: {{ 'booking.locations' | route_url }}.

booking.services

The service step for one location.

Template templates/booking.services.liquid; drops; tracking tags may load (the cookie banner is required).

Link: {{ 'booking.services' | route_url: location: … }} (location: see Links in the slots guide).

booking.staff

The staff step, choosing who does the service, or anyone.

Template templates/booking.staff.liquid; drops; tracking tags may load (the cookie banner is required).

Link: {{ 'booking.staff' | route_url: location: …, service: … }} (location, service: see Links in the slots guide).

booking.times

The time step, choosing a day and a time.

Template templates/booking.times.liquid; drops; tracking tags may load (the cookie banner is required).

Link: {{ 'booking.times' | route_url: location: …, service: … }} (location, service: see Links in the slots guide).

withdrawals.order

Withdrawing from an order (the right of withdrawal), from the link in the receipt.

Template templates/withdrawals.order.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

withdrawals.order_receipt

The receipt for an order's withdrawal.

Template templates/withdrawals.order_receipt.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

withdrawals.membership

Withdrawing from a membership sign-up.

Template templates/withdrawals.membership.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

withdrawals.membership_receipt

The receipt for a membership's withdrawal.

Template templates/withdrawals.membership_receipt.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

punch_cards.list

The punch cards the tenant sells.

Template templates/punch_cards.list.liquid; drops; tracking tags never load.

Link: {{ 'punch_cards.list' | route_url }}.

waitlist.join

Joining the waitlist for a service.

Template templates/waitlist.join.liquid; drops; tracking tags may load (the cookie banner is required).

Link: {{ 'waitlist.join' | route_url: location: …, service: … }} (location, service: see Links in the slots guide).

waitlist.entry

One waitlist entry, from the link the customer was sent.

Template templates/waitlist.entry.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

legal.text

One of the tenant's legal texts (terms, privacy policy).

Template templates/legal.text.liquid; drops; tracking tags never load.

Link: {{ 'legal.text' | route_url: kind: … }} (kind: see Links in the slots guide).

errors.not_found

The page shown for an address that does not exist on the booking host.

Template templates/errors.not_found.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

catalog.price_list

The tenant's price list.

Template templates/catalog.price_list.liquid; drops; tracking tags never load.

Link: {{ 'catalog.price_list' | route_url: location: … }} (location: see Links in the slots guide).

sickness_recovery.case

Rebooking an appointment a sick colleague had, from the link the customer was sent.

Template templates/sickness_recovery.case.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

messaging.unsubscribe

Unsubscribing from marketing messages, from the link in a message.

Template templates/messaging.unsubscribe.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

A membership card link that can no longer be used, and why.

Template templates/memberships.card_link_unavailable.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

memberships.invitation_unavailable

A membership sign-up invitation that can no longer be used, and why.

Template templates/memberships.invitation_unavailable.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

errors.too_many_requests

The page shown when the customer has sent too many requests in a short time.

Template templates/errors.too_many_requests.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

The card link's login step once the card is saved.

Template templates/memberships.card_link_login.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

The page after saving the card from a card link, with its status.

Template templates/memberships.card_link_status.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

booking.details

The customer's details, the consents and, with nothing to pay, the order.

Template templates/booking.details.liquid; drops; tracking tags may load (the cookie banner is required).

Link: {{ 'booking.details' | route_url: location: …, service: … }} (location, service: see Links in the slots guide).

Containers (each slot listed sits inside it, and nowhere else):

booking.booking

The booking's own page, held, cancelled or confirmed.

Template templates/booking.booking.liquid; drops; tracking tags may load (the cookie banner is required).

No link: this page is reached only from a link Truly sends, or it is an error page.

Containers (each slot listed sits inside it, and nowhere else):

booking.payment

The payment step, with the consents and the order, while the time is held.

Template templates/booking.payment.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

Containers (each slot listed sits inside it, and nowhere else):

waitlist.offer

A waitlist offer of a free time, from the link the customer was sent, with the terms box where the time is booked on the page.

Template templates/waitlist.offer.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

growth.offer

A Calendar Fill offer of a free time at a discount, from the link the customer was sent, with the terms box where the time is booked on the page.

Template templates/growth.offer.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

checkout.order_status

The page after paying in the payment window (a held booking or a payment link), with the payment's status and, once paid, the withdrawal notice.

Template templates/checkout.order_status.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

Containers (each slot listed sits inside it, and nowhere else):

punch_cards.purchase

Buying a punch card, with its terms box, the withdrawal information and the order.

Template templates/punch_cards.purchase.liquid; drops; tracking tags never load.

Link: {{ 'punch_cards.purchase' | route_url: product: … }} (product: see Links in the slots guide).

Containers (each slot listed sits inside it, and nowhere else):

punch_cards.purchase_status

The page after paying for a punch card, with the payment's status and, once paid, the withdrawal notice.

Template templates/punch_cards.purchase_status.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

Containers (each slot listed sits inside it, and nowhere else):

The card link of a member moved from the previous system, with the membership terms box, the card mandate and the order.

Template templates/memberships.card_link.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

Containers (each slot listed sits inside it, and nowhere else):

gift_cards.purchase

Buying a gift card, with its terms box, the withdrawal information and the order.

Template templates/gift_cards.purchase.liquid; drops; tracking tags never load.

Link: {{ 'gift_cards.purchase' | route_url: product: … }} (product: see Links in the slots guide).

Containers (each slot listed sits inside it, and nowhere else):

gift_cards.purchase_status

The page after paying for a gift card, with the payment's status and, once paid, the link to withdraw.

Template templates/gift_cards.purchase_status.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

Paying an order from a payment link, with the order while the link is payable.

Template templates/checkout.payment_link.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

customers.sign_in

The customer's sign-in form (email or SMS, and passkeys where the tenant offers them).

Template templates/customers.sign_in.liquid; drops; tracking tags never load.

Link: {{ 'customers.sign_in' | route_url }}.

customers.sign_in_code

Entering the sign-in code the customer was sent.

Template templates/customers.sign_in_code.liquid; drops; tracking tags never load.

Link: {{ 'customers.sign_in_code' | route_url }}.

memberships.plans

The tenant's membership plans.

Template templates/memberships.plans.liquid; drops; tracking tags never load.

Link: {{ 'memberships.plans' | route_url }}.

memberships.signup

Signing up for one membership plan, with the consents, the withdrawal information and the order.

Template templates/memberships.signup.liquid; drops; tracking tags never load.

Link: {{ 'memberships.signup' | route_url: plan: … }} (plan: see Links in the slots guide).

memberships.confirmation

The page the customer returns to after signing up, with the sign-up's status.

Template templates/memberships.confirmation.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

customers.membership

Min side's membership page, with the actions on a running membership.

Template templates/customers.membership.liquid; drops; tracking tags never load.

Link: {{ 'customers.membership' | route_url }}.

Containers (each slot listed sits inside it, and nowhere else):

customers.bookings

Min side's bookings, with cancelling.

Template templates/customers.bookings.liquid; drops; tracking tags never load.

Link: {{ 'customers.bookings' | route_url }}.

customers.booking_reschedule

Moving a booking to another time.

Template templates/customers.booking_reschedule.liquid; drops; tracking tags never load.

No link: this page is reached only from a link Truly sends, or it is an error page.

customers.profile

The customer's profile and sign-in methods.

Template templates/customers.profile.liquid; drops; tracking tags never load.

Link: {{ 'customers.profile' | route_url }}.

customers.saved_cards

The customer's saved cards.

Template templates/customers.saved_cards.liquid; drops; tracking tags never load.

Link: {{ 'customers.saved_cards' | route_url }}.

customers.consents

The customer's marketing consents.

Template templates/customers.consents.liquid; drops; tracking tags never load.

Link: {{ 'customers.consents' | route_url }}.

customers.referral

The customer's referral code and rewards.

Template templates/customers.referral.liquid; drops; tracking tags never load.

Link: {{ 'customers.referral' | route_url }}.

customers.waitlist

The customer's waitlist entries.

Template templates/customers.waitlist.liquid; drops; tracking tags never load.

Link: {{ 'customers.waitlist' | route_url }}.

customers.data_export

Asking for a copy of the customer's data.

Template templates/customers.data_export.liquid; drops; tracking tags never load.

Link: {{ 'customers.data_export' | route_url }}.

customers.deletion_request

Asking for the customer's account to be deleted, and its status.

Template templates/customers.deletion_request.liquid; drops; tracking tags never load.

Link: {{ 'customers.deletion_request' | route_url }}.