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:
--truly-color-primary: The main action colour (buttons, selected choices).--truly-color-primary-foreground: Text on the main action colour.--truly-color-card: The background of cards and fields.--truly-color-card-foreground: Text on cards.--truly-color-border: Borders and dividers.--truly-color-input: The border of fields.--truly-radius: The base corner radius; smaller and larger corners scale from it.--truly-card-padding: The padding inside a card and the gap between its parts.
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.
legal_text
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.
card_link_unavailable
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.
card_link_login
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.
card_link_status
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.
label_da,label_en: The order button's wording per locale, for examplelabel_da: 'Bestil og betal'. Leave it out for Truly's default wording; one locale alone leaves the other at the default.
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.
consent
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.
role: Which consent the box asks for.- Roles:
terms,mandate,perform_now,marketing
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.
footer
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.
cookie_banner
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.
header
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.
payment_link
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.
payment_link_terms
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.
card_link_form
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.
card_link_plan
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.
consent_settings
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.