Truly theme developer docs Guides Reference (format 1)

Slots and hooks

A slot is one of Truly's components, placed with {% slot 'name' %}. Most slots have no children: the component
draws its own content. A container slot is a block, {% slot 'name' %}…{% endslot %}: Truly draws its container
(the step's section, the consents' region, a membership's card) and your markup and slots between the tags inside
it, in your order. The legal parts sit inside their container, each where its route's rules say; a container
written without {% endslot %} is a syntax error. No slot may sit inside a link. Field values are literal text of at most
256 characters. Which slots a page needs is in Routes and states.

Your CSS styles a slot from outside: inherited properties (colour, font) flow into it, element selectors stop at
its edge (and reach your own markup inside a container again), and the hooks below are the only parts of a component you may select. A hook belongs to a
format_version: it keeps working for themes of that version.

Every slot's components read these custom properties. Set them on your own element around the slots (they
inherit); unset, each keeps Truly's value:

location_picker

The location step with its list of locations.

{% slot 'location_picker' %} on booking.locations.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.

service_picker

The service step with its list of services.

{% slot 'service_picker' %} on booking.services.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.

staff_picker

The staff step with its list of staff.

{% slot 'staff_picker' %} on booking.staff.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.

time_picker

The time step with its calendar and times.

{% slot 'time_picker' %} on booking.times.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.

plan_list

The list of membership plans.

{% slot 'plan_list' %} on memberships.plans.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.

signup_form

The sign-up's title and form (card, salon and the customer's details).

{% slot 'signup_form' %} on memberships.signup.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.; [data-part="input"]: A text field.

signup_status

The sign-up's status after the customer returns.

{% slot 'signup_status' %} on memberships.confirmation.

Hooks: none.

details_form

A container: the details step (the customer's details and the credit switch, and with an amount due the button on to the payment step) around the consents, the account box, the terms box and the order.

{% slot 'details_form' %}…{% endslot %} on booking.details.
A container: it holds consent:marketing on booking.details, create_account on booking.details, details_terms on booking.details, order on booking.details.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.; [data-part="input"]: A text field.

booking_status

A container: the booking's own page (the hold with its timer, the cancellation or the confirmation), with the withdrawal notice beside the summary.

{% slot 'booking_status' %}…{% endslot %} on booking.booking.
A container: it holds withdrawal_notice on booking.booking.

Hooks: none.

payment_step

A container: the payment step (the code field and the cancellation fee) around the consents, the withdrawal information and the order.

{% slot 'payment_step' %}…{% endslot %} on booking.payment.
A container: it holds payment_consents on booking.payment, payment_withdrawal on booking.payment, order on booking.payment.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.; [data-part="input"]: A text field.

membership_termination

Cancelling a running membership. Required wherever a membership is shown.

{% slot 'membership_termination' %} on customers.membership.
Sits inside membership_status on customers.membership.

Hooks: none.

membership_pause

Pausing a membership.

{% slot 'membership_pause' %} on customers.membership.
Sits inside membership_status on customers.membership.

Hooks: none.

membership_card

Changing the card a membership is paid with.

{% slot 'membership_card' %} on customers.membership.
Sits inside membership_status on customers.membership.

Hooks: none.

membership_payments

A membership's payments and receipts.

{% slot 'membership_payments' %} on customers.membership.
Sits inside membership_status on customers.membership.

Hooks: none.

order_withdrawal

The order withdrawal form.

{% slot 'order_withdrawal' %} on withdrawals.order.

Hooks: none.

order_withdrawal_receipt

The order withdrawal receipt.

{% slot 'order_withdrawal_receipt' %} on withdrawals.order_receipt.

Hooks: none.

membership_withdrawal

The membership withdrawal form.

{% slot 'membership_withdrawal' %} on withdrawals.membership.

Hooks: none.

membership_withdrawal_receipt

The membership withdrawal receipt.

{% slot 'membership_withdrawal_receipt' %} on withdrawals.membership_receipt.

Hooks: none.

punch_card_list

The punch cards for sale.

{% slot 'punch_card_list' %} on punch_cards.list.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.

waitlist_join

Joining the waitlist.

{% slot 'waitlist_join' %} on waitlist.join.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.; [data-part="input"]: A text field.

waitlist_entry

The waitlist entry and its actions.

{% slot 'waitlist_entry' %} on waitlist.entry.

Hooks: none.

The legal text.

{% slot 'legal_text' %} on legal.text.

Hooks: none.

not_found

The not-found message with a link back to booking.

{% slot 'not_found' %} on errors.not_found.

Hooks: none.

price_list

The price list.

{% slot 'price_list' %} on catalog.price_list.

Hooks: none.

recovery_case

The rebooking page with its choice of new times, or its outcome.

{% slot 'recovery_case' %} on sickness_recovery.case.

Hooks: none.

unsubscribe

The unsubscribe confirmation, or its outcome.

{% slot 'unsubscribe' %} on messaging.unsubscribe.

Hooks: none.

The message that the card link can no longer be used.

{% slot 'card_link_unavailable' %} on memberships.card_link_unavailable.

Hooks: none.

invitation_unavailable

The message that the invitation can no longer be used.

{% slot 'invitation_unavailable' %} on memberships.invitation_unavailable.

Hooks: none.

too_many_requests

The too-many-requests message.

{% slot 'too_many_requests' %} on errors.too_many_requests.

Hooks: none.

The card link's login step (the offer, the code field or the outcome).

{% slot 'card_link_login' %} on memberships.card_link_login.

Hooks: none.

The card link's status after the provider's window (waiting, saved, charging or not paid).

{% slot 'card_link_status' %} on memberships.card_link_status.

Hooks: none.

order

The order summary directly followed by the order button. They cannot be separated.

{% slot 'order' %} on booking.details, booking.payment, punch_cards.purchase, memberships.card_link, gift_cards.purchase, checkout.payment_link, memberships.signup.
Sits inside details_form on booking.details, payment_step on booking.payment, punch_card_purchase on punch_cards.purchase, card_link_form on memberships.card_link, gift_card_purchase on gift_cards.purchase.

Hooks: [data-part="order"]: The element holding the order summary and the order button.; [data-part="summary"]: The order summary's card (the lines and the total).; [data-part="button"]: A button.

One consent checkbox, by role.

{% slot 'consent', role: 'terms' %} on booking.details, booking.payment, waitlist.offer, growth.offer, punch_cards.purchase, memberships.card_link, gift_cards.purchase, memberships.signup.
Sits inside details_form (consent:marketing) on booking.details, details_terms (consent:terms) on booking.details, payment_consents (consent:terms) on booking.payment, payment_consents (consent:perform_now) on booking.payment, punch_card_terms (consent:terms) on punch_cards.purchase, card_link_plan (consent:terms) on memberships.card_link, card_link_plan (consent:mandate) on memberships.card_link, gift_card_terms (consent:terms) on gift_cards.purchase.

Hooks: none.

withdrawal_notice

The notice of the right of withdrawal on a confirmed booking.

{% slot 'withdrawal_notice' %} on booking.booking, checkout.order_status, punch_cards.purchase_status.
Sits inside booking_status on booking.booking, order_status on checkout.order_status, punch_card_status on punch_cards.purchase_status.

Hooks: none.

model_withdrawal_form

The model withdrawal form.

{% slot 'model_withdrawal_form' %} on booking.payment, punch_cards.purchase, gift_cards.purchase, memberships.signup.
Sits inside payment_withdrawal on booking.payment, punch_card_withdrawal on punch_cards.purchase, gift_card_withdrawal on gift_cards.purchase.

Hooks: none.

signup_withdrawal_info

The sign-up's withdrawal information (the deadline, and where and how to withdraw).

{% slot 'signup_withdrawal_info' %} on memberships.signup.

Hooks: none.

The legal footer with the tenant's details and the cookie settings link. Required in the layout.

{% slot 'footer' %} on booking.locations, booking.services, booking.staff, booking.times, withdrawals.order, withdrawals.order_receipt, withdrawals.membership, withdrawals.membership_receipt, punch_cards.list, waitlist.join, waitlist.entry, legal.text, errors.not_found, catalog.price_list, sickness_recovery.case, messaging.unsubscribe, memberships.card_link_unavailable, memberships.invitation_unavailable, errors.too_many_requests, memberships.card_link_login, memberships.card_link_status, booking.details, booking.booking, booking.payment, waitlist.offer, growth.offer, checkout.order_status, punch_cards.purchase, punch_cards.purchase_status, memberships.card_link, gift_cards.purchase, gift_cards.purchase_status, checkout.payment_link, customers.sign_in, customers.sign_in_code, memberships.plans, memberships.signup, memberships.confirmation, customers.membership, customers.bookings, customers.booking_reschedule, customers.profile, customers.saved_cards, customers.consents, customers.referral, customers.waitlist, customers.data_export, customers.deletion_request.

Hooks: none.

The cookie consent banner. Required where tracking tags may load.

{% slot 'cookie_banner' %} on booking.locations, booking.services, booking.staff, booking.times, withdrawals.order, withdrawals.order_receipt, withdrawals.membership, withdrawals.membership_receipt, punch_cards.list, waitlist.join, waitlist.entry, legal.text, errors.not_found, catalog.price_list, sickness_recovery.case, messaging.unsubscribe, memberships.card_link_unavailable, memberships.invitation_unavailable, errors.too_many_requests, memberships.card_link_login, memberships.card_link_status, booking.details, booking.booking, booking.payment, waitlist.offer, growth.offer, checkout.order_status, punch_cards.purchase, punch_cards.purchase_status, memberships.card_link, gift_cards.purchase, gift_cards.purchase_status, checkout.payment_link, customers.sign_in, customers.sign_in_code, memberships.plans, memberships.signup, memberships.confirmation, customers.membership, customers.bookings, customers.booking_reschedule, customers.profile, customers.saved_cards, customers.consents, customers.referral, customers.waitlist, customers.data_export, customers.deletion_request.

Hooks: none.

Truly's booking header with the tenant's logo.

{% slot 'header' %} on booking.locations, booking.services, booking.staff, booking.times, withdrawals.order, withdrawals.order_receipt, withdrawals.membership, withdrawals.membership_receipt, punch_cards.list, waitlist.join, waitlist.entry, legal.text, errors.not_found, catalog.price_list, sickness_recovery.case, messaging.unsubscribe, memberships.card_link_unavailable, memberships.invitation_unavailable, errors.too_many_requests, memberships.card_link_login, memberships.card_link_status, booking.details, booking.booking, booking.payment, waitlist.offer, growth.offer, checkout.order_status, punch_cards.purchase, punch_cards.purchase_status, memberships.card_link, gift_cards.purchase, gift_cards.purchase_status, checkout.payment_link, customers.sign_in, customers.sign_in_code, memberships.plans, memberships.signup, memberships.confirmation, customers.membership, customers.bookings, customers.booking_reschedule, customers.profile, customers.saved_cards, customers.consents, customers.referral, customers.waitlist, customers.data_export, customers.deletion_request.

Hooks: none.

sign_in_form

The customer sign-in form.

{% slot 'sign_in_form' %} on customers.sign_in.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.; [data-part="input"]: A text field.

sign_in_code_form

The sign-in code form.

{% slot 'sign_in_code_form' %} on customers.sign_in_code.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.; [data-part="input"]: A text field.

create_account

The details step's optional "create an account" box (shown to a guest).

{% slot 'create_account' %} on booking.details.
Sits inside details_form on booking.details.

Hooks: none.

details_terms

A container: the details step's terms box, the cancellation policy and then the terms consent where terms are published. Drawn while nothing is to pay.

{% slot 'details_terms' %}…{% endslot %} on booking.details.
A container: it holds consent:terms on booking.details.
Sits inside details_form on booking.details.

Hooks: none.

payment_consents

A container: the payment step's consents region, with its heading.

{% slot 'payment_consents' %}…{% endslot %} on booking.payment.
A container: it holds consent:terms on booking.payment, consent:perform_now on booking.payment.
Sits inside payment_step on booking.payment.

Hooks: none.

payment_withdrawal

A container: the payment step's withdrawal information (the deadline and the links), with the model withdrawal form where the right applies.

{% slot 'payment_withdrawal' %}…{% endslot %} on booking.payment.
A container: it holds model_withdrawal_form on booking.payment.
Sits inside payment_step on booking.payment.

Hooks: none.

The payment link's text and its form (what is paid, the amount and the due date).

{% slot 'payment_link' %} on checkout.payment_link.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.; [data-part="input"]: A text field.

The links to the tenant's terms and privacy policy under the payment link.

{% slot 'payment_link_terms' %} on checkout.payment_link.

Hooks: none.

order_status

A container: the payment's status after the payment window (waiting, not paid or confirmed) with the order's summary, and the withdrawal notice beside the summary.

{% slot 'order_status' %}…{% endslot %} on checkout.order_status.
A container: it holds withdrawal_notice on checkout.order_status.

Hooks: none.

waitlist_offer

The waitlist offer's heading, its notices and the offered time.

{% slot 'waitlist_offer' %} on waitlist.offer.

Hooks: none.

waitlist_offer_more

The entry's other free times and the links to the app and the waitlist entry.

{% slot 'waitlist_offer_more' %} on waitlist.offer.

Hooks: none.

waitlist_offer_terms

The cancellation policy before the terms box, where the time is booked on the page.

{% slot 'waitlist_offer_terms' %} on waitlist.offer.

Hooks: none.

waitlist_offer_book

The button that books the offered time on the page.

{% slot 'waitlist_offer_book' %} on waitlist.offer.

Hooks: none.

growth_offer

The offer's heading, its notices and the offered time with its prices.

{% slot 'growth_offer' %} on growth.offer.

Hooks: none.

growth_offer_more

The other free times at the offer price.

{% slot 'growth_offer_more' %} on growth.offer.

Hooks: none.

growth_offer_terms

The cancellation policy before the terms box, where the time is booked on the page.

{% slot 'growth_offer_terms' %} on growth.offer.

Hooks: none.

growth_offer_book

The button that books the offered time on the page.

{% slot 'growth_offer_book' %} on growth.offer.

Hooks: none.

punch_card_purchase

The punch card purchase's form (the card, the buyer's details), a container for the terms card, the withdrawal card and the order.

{% slot 'punch_card_purchase' %}…{% endslot %} on punch_cards.purchase.
A container: it holds punch_card_terms on punch_cards.purchase, punch_card_withdrawal on punch_cards.purchase, order on punch_cards.purchase.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.; [data-part="input"]: A text field.

punch_card_terms

The punch card's terms card (validity, cash-out), a container for the terms box.

{% slot 'punch_card_terms' %}…{% endslot %} on punch_cards.purchase.
A container: it holds consent:terms on punch_cards.purchase.
Sits inside punch_card_purchase on punch_cards.purchase.

Hooks: none.

punch_card_withdrawal

The withdrawal information card (deadline, link), a container for the model withdrawal form.

{% slot 'punch_card_withdrawal' %}…{% endslot %} on punch_cards.purchase.
A container: it holds model_withdrawal_form on punch_cards.purchase.
Sits inside punch_card_purchase on punch_cards.purchase.

Hooks: none.

punch_card_status

The punch card payment's status (waiting, not paid or confirmed), a container for the withdrawal notice.

{% slot 'punch_card_status' %}…{% endslot %} on punch_cards.purchase_status.
A container: it holds withdrawal_notice on punch_cards.purchase_status.

Hooks: none.

gift_card_purchase

The gift card purchase's form (the card, the recipient, the buyer), a container for the terms card, the withdrawal card and the order.

{% slot 'gift_card_purchase' %}…{% endslot %} on gift_cards.purchase.
A container: it holds gift_card_terms on gift_cards.purchase, gift_card_withdrawal on gift_cards.purchase, order on gift_cards.purchase.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.; [data-part="input"]: A text field.

gift_card_terms

The gift card's terms card (validity, cash-out), a container for the terms box.

{% slot 'gift_card_terms' %}…{% endslot %} on gift_cards.purchase.
A container: it holds consent:terms on gift_cards.purchase.
Sits inside gift_card_purchase on gift_cards.purchase.

Hooks: none.

gift_card_withdrawal

The withdrawal information card (deadline, link), a container for the model withdrawal form.

{% slot 'gift_card_withdrawal' %}…{% endslot %} on gift_cards.purchase.
A container: it holds model_withdrawal_form on gift_cards.purchase.
Sits inside gift_card_purchase on gift_cards.purchase.

Hooks: none.

gift_card_status

The gift card payment's status (waiting, not paid or confirmed with the link to withdraw).

{% slot 'gift_card_status' %} on gift_cards.purchase_status.

Hooks: none.

The card link's form (the member, the plan, the errors), a container for the plan card and the order.

{% slot 'card_link_form' %}…{% endslot %} on memberships.card_link.
A container: it holds card_link_plan on memberships.card_link, order on memberships.card_link.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.; [data-part="input"]: A text field.

The plan card (price, paid-until and first charge dates), a container for the terms box and the card mandate.

{% slot 'card_link_plan' %}…{% endslot %} on memberships.card_link.
A container: it holds consent:terms on memberships.card_link, consent:mandate on memberships.card_link.
Sits inside card_link_form on memberships.card_link.

Hooks: none.

booking_list

The customer's bookings.

{% slot 'booking_list' %} on customers.bookings.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.

reschedule_form

Choosing a new time for a booking.

{% slot 'reschedule_form' %} on customers.booking_reschedule.

Hooks: [data-part="card"]: A card, the box around a group of choices or fields.; [data-part="button"]: A button.; [data-part="input"]: A text field.

profile_logins

The profile and sign-in methods.

{% slot 'profile_logins' %} on customers.profile.

Hooks: none.

saved_card_list

The saved cards.

{% slot 'saved_card_list' %} on customers.saved_cards.

Hooks: none.

The marketing consent settings.

{% slot 'consent_settings' %} on customers.consents.

Hooks: none.

membership_status

A container: the customer's memberships. Its children (the membership actions) are drawn in each membership's card.

{% slot 'membership_status' %}…{% endslot %} on customers.membership.
A container: it holds membership_termination on customers.membership, membership_pause on customers.membership, membership_card on customers.membership, membership_payments on customers.membership.

Hooks: none.

referral_status

The referral code and rewards.

{% slot 'referral_status' %} on customers.referral.

Hooks: none.

waitlist_entries

The waitlist entries.

{% slot 'waitlist_entries' %} on customers.waitlist.

Hooks: none.

data_export_form

Asking for a data export.

{% slot 'data_export_form' %} on customers.data_export.

Hooks: none.

deletion_request_status

Asking for deletion, and the request's status.

{% slot 'deletion_request_status' %} on customers.deletion_request.

Hooks: none.