Black Friday
Skip to documentation content

Booking Operations

Customize booking email content and branding

Learn what Free and Pro provide, then customize booking email branding and wording by language, preview and test drafts, apply changes and restore earlier versions.

Customize the wording, logo and colors of booking emails without changing your hotel theme. KimoraPro Hotel Booking Free provides the shared email system and developer customization contract; Hotel Booking Pro adds the administrator template editor, drafts, previews, test emails and history.

Available from: Free 3.30.0 and Pro 1.38.0. Update Free first, then Pro. The editor is part of Pro’s advanced email features and does not require a separate email-template license.

What Free and Pro provide

  • Free: the default booking-email layout, supported placeholders, protected booking details, fallback rendering and the public contract for developer customization from a site plugin.
  • Pro: the visual controls for shared branding and wording per email type and language, with Save draft, Preview changes, Send test, Apply draft and History.
  • Every theme: the same email system. Switching themes keeps your saved design, templates and history.

The Templates editor needs an active Pro entitlement that includes advanced email features and permission to manage email templates. This permission is assigned to Administrators by default; Hotel Manager, Receptionist and Editor roles do not receive it automatically. Free-only sites can use the developer contract but do not have the Pro editor.

Set your shared design

  1. Open Hotel Booking → Email Settings → Templates.
  2. Under Shared design, choose Edit design.
  3. Choose a logo from the Media Library, enter its text alternative and set the background, header and accent colors. The accent color is used for buttons and highlights. Add a shared footer if needed.
  4. Choose Save draft, review the preview and select Apply draft when ready.

The shared design has its own draft, applied version and history. Saving a design draft does not change emails being sent. A custom footer on an individual email template overrides the shared footer; leaving that field on Use default inherits the shared footer.

Edit an email and language

  1. Return to the Templates list, choose Email language and select Show.
  2. Select Edit beside the email you want to customize.
  3. For each field, select Use default to inherit the current default, or Custom to enter your own wording.
  4. Edit the Subject, Heading, Greeting, Introduction, Button label and Footer text as needed.
  5. Select Save draft. Check the preview and optionally send a test, then select Apply draft.

Each email type and language has a separate template. A language without a custom template uses its translated default, together with the applied shared design. Custom text is not automatically translated into other languages. The guest email still follows the booking’s saved language; choosing a language in the editor does not change a booking.

Use default continues to inherit the current default rather than freezing a copy of it. Custom with an empty value intentionally leaves an optional field blank. Subject and Button label cannot be blank. The button label appears only when the email has an available action; its destination is managed by Hotel Booking.

Use placeholders and supported formatting

Use the editor’s placeholder controls or enter these supported placeholders exactly:

  • {{hotel.name}} — hotel name, falling back to the site name.
  • {{guest.name}} — the guest’s full name, falling back to the translated word “Guest”.
  • {{booking.code}} — booking code.
  • {{stay.check_in}} and {{stay.check_out}} — localized stay dates.

For example, a subject can be Your booking {{booking.code}} at {{hotel.name}} and a greeting can be Hello {{guest.name}},. Missing booking codes or stay dates resolve to an empty value. Unsupported or malformed placeholders show validation errors and prevent Apply.

Subject, Heading and Greeting allow up to 200 characters each; Introduction allows 5,000, Button label 60 and Footer text 2,000. Introduction and Footer text support paragraphs, line breaks, bold, italic, underline, lists and links using http, https or mailto. Arbitrary HTML, images inside text, inline styles, scripts, iframes, shortcodes and PHP are not supported. Use the shared Logo control for the logo. Do not place placeholders inside HTML attributes.

Preview and send a test

Preview changes includes the current unsaved edits. Use the sample situations to review unpaid, partially paid, paid and cancelled messages, no-action messages, policy blocks, right-to-left text and long names. Check both Desktop and Mobile widths. Preview uses sample data and creates no booking, invoice, real action link or queued email.

Send test sends the saved draft with sample data to the address you enter, so save your latest changes first. The subject starts with [TEST]; it contains no real guest data, invoice or working booking/review link. Limits are five test emails per user per ten minutes and thirty per website per hour. A successful result means WordPress accepted the message for sending; verify arrival in the destination inbox separately.

The older Send Test control under Notifications & delivery checks mail connectivity. Use the Templates editor’s Send test to inspect your saved template design and wording.

Apply, restore and keep history

Apply draft makes the saved draft active for newly generated emails. Messages already in the queue keep their stored subject and body, including when retried; previously sent messages are not rewritten.

In History, select Restore as draft to recover an earlier version. Restore defaults as a draft creates a draft that inherits the defaults. Review and apply that draft to activate the restoration. Design and individual templates are restored separately. If another administrator saves or applies changes after you opened the editor, a conflict prevents overwriting their changes and keeps your entered content available for review.

Which emails are covered?

The catalog covers thirteen booking email types:

  • Guest: booking created, status changed, payment received, refund recorded, cancellation, no-show, late-payment refund, check-in reminder and review request.
  • Staff: booking created, payment received, cancellation and late-payment refund.

Check-in reminders and review requests require their sending features to be available. A type marked Not available cannot be edited until its feature is enabled. An email turned off under Notifications & delivery can still be customized, but editing or applying a template does not turn it on.

Welcome emails, password resets, Contact, Newsletter and other WordPress or WooCommerce messages use separate flows. This editor does not customize those messages or the PDF invoice document itself.

What remains managed by Hotel Booking?

Booking details, amounts and payment status, operational notices, applicable saved room and cancellation policies, action destinations and support details remain system-managed. Customization does not change recipients, delivery schedules, booking status, payments, attachments or feature availability. Editing a button label cannot create a guest-account link on a Free-only site.

Troubleshooting and saved data

  • Templates is missing or unavailable: check your role, Pro advanced-email entitlement and versions. Older Free versions need updating to provide Email Customization Contract 1.x.
  • A field is managed by a developer layout: that layout does not support editing the field. Ask the developer to update its declared support.
  • A developer layout fails: Hotel Booking falls back to its default layout while keeping the resolved content. Review the Developer layouts diagnostics on the Templates page.
  • Your changes are absent: confirm the right email type and language, apply both the relevant design and template drafts, and inspect a newly generated message rather than an older queued email.

Deactivating Pro, losing the required entitlement or switching themes does not delete saved templates or history. When Pro customization is unavailable, newly generated emails use an eligible developer layout or the Core default without the Pro administrator profile. Uninstalling Pro also keeps templates by default; deletion requires explicitly enabling and confirming the option under Data retention.

Continue with Verify booking emails and PDF invoices, Understand booking, email and invoice languages, or the Email Customization Contract for developers.

Was this article helpful?

Your feedback helps us improve the documentation.