---
title: HTML Template Troubleshooting Guide
description: Tips and tricks on using HTML in emails
---

[Skip to content](https://help.nowbookit.com/html-template-troubleshooting-guide#main-content)

English

Show submenu for translations

[![NowBookIt-Alt-Logo 2-1](https://help.nowbookit.com/hs-fs/hubfs/NowBookIt-Alt-Logo%202-1.png?width=300&height=75&name=NowBookIt-Alt-Logo%202-1.png)](https://nowbookit.com)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [New Now Book It Experience](https://help.nowbookit.com/knowledge-base)

[New Now Book It Experience](https://help.nowbookit.com/knowledge-base?hsLang=en)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Help Centre](https://help.nowbookit.com/?hsLang=en)
2. [Configuration and Communication](https://help.nowbookit.com/configuration-and-communication?hsLang=en)
3. [Email and Communications](https://help.nowbookit.com/configuration-and-communication?hsLang=en#email-and-communications)

# HTML Template Troubleshooting Guide

## Tips and frequent questions for HTML emails on Now Book It

### Introduction

The HTML template editor makes email creation accessible to everyone without coding expertise. However, even when using the visual editor, it's easy to accidentally break your template. This guide focuses on one main goal: **keeping your HTML code intact** while making customisations.

### Common Ways HTML gets broken

#### Merged Tags

Merge tags are placeholders that you can use in your templates to dynamically insert information. These placeholders get replaced with actual content when the email or template is rendered.

For example, instead of manually typing a user’s name every time you send an email, you can use a merge tag like `{{firstName}}` and it will automatically insert the user’s first name when the email is sent.

**What happens:** Your personalisation doesn't work, or worse, your merge tags appear as literal text in your sent emails.

**Common mistakes:**

`<!-- Missing closing braces --> Hello {{firstName <!-- Extra spaces --> Hello {{ firstName }} <!-- Incorrect syntax --> Hello {firstName}`

 

**Correct format:**

`Hello {{firstName}}`

**Prevention tip:** Copy and paste existing merge tags rather than typing them manually.

 

#### Breaking Conditional Logic

If statements allow you to add conditional logic to your templates. With an if statement, you can show or hide content based on certain conditions. For example, in the successful booking email, company name will only show if it has been entered by the customer during the booking process.

**What happens:** Content that should be conditionally shown/hidden appears incorrectly or not at all.

**Common mistakes:**

`<!-- Missing % symbol --> {if Requirements != ''} <p>content here</p> {endif} <!-- Mismatched opening/closing tags --> {%if Requirements != ''%} <p>content here</p> {%if%} <!-- Unclosed conditional statement --> {% if Requirements != ''%} <p>{{Requirements}}</p>`

 

**Correct format:**

`{% if Requirements != ''%} {{Requirements}} {%endif%}`

**Prevention tip:** Keep conditional logic simple. Test with different data scenarios.

 

### Common Button Problems and Solutions

Buttons are particularly prone to breaking in email templates. Here are common issues:

**Disappearing buttons:**

- Cause: Accidentally deleting the container element
- Solution: Always select the button text, not the entire button, when editing
- Prevention: Use the structure panel to identify the button component before editing

**Broken links:**

- Cause: Incomplete URLs (missing "https://") or spaces in URLs or merged tag has incorrect syntax
- Solution: Always include the full URL starting with "http://" or "https://" and check the merged tag syntax (see above)
- Prevention: Test all links in preview mode before sending

**Buttons displaying as plain text:**

- Cause: Editing button HTML directly and breaking the code structure
- Solution: Recreate the button using the button element tool
- Prevention: Only edit button text and properties through the visual editor

**Inconsistent button appearance across email clients:**

- Cause: Using unsupported styling options
- Solution: Stick to basic button styles and avoid gradients or complex effects
- Prevention: Test emails in multiple clients before sending

### Safe Editing Practices

#### Make One Change at a Time

Don't try to make multiple changes at once. Make a single change, then test it before moving on.

#### Use the Test email feature

After each change, click the test email to make sure nothing is broken.

- [Get Started](https://help.nowbookit.com/get-started?hsLang=en#main-content)

    - [Onboarding and Setup](https://help.nowbookit.com/get-started?hsLang=en#onboarding-and-setup)
    - [Your Account and Subscription](https://help.nowbookit.com/get-started?hsLang=en#your-account-and-subscription)
    - [User Management](https://help.nowbookit.com/get-started?hsLang=en#user-management)
- [Diary / Bookings / Customers](https://help.nowbookit.com/diary-bookings-customers?hsLang=en#main-content)

    - [Managing Bookings](https://help.nowbookit.com/diary-bookings-customers?hsLang=en#managing-bookings)
    - [Diary Views and Settings](https://help.nowbookit.com/diary-bookings-customers?hsLang=en#diary-views-and-settings)
    - [Floor Plan](https://help.nowbookit.com/diary-bookings-customers?hsLang=en#floor-plan)
    - [Blockouts](https://help.nowbookit.com/diary-bookings-customers?hsLang=en#blockouts)
    - [Standby List and Wait List](https://help.nowbookit.com/diary-bookings-customers?hsLang=en#standby-list-and-wait-list)
    - [Diary Mobile](https://help.nowbookit.com/diary-bookings-customers?hsLang=en#diary-mobile)
    - [Customers](https://help.nowbookit.com/diary-bookings-customers?hsLang=en#customers)
    - [Booking Options and Services](https://help.nowbookit.com/diary-bookings-customers?hsLang=en#booking-options-and-services)
    - [Takeaway](https://help.nowbookit.com/diary-bookings-customers?hsLang=en#takeaway)
- [Events and Special Occasions](https://help.nowbookit.com/events-and-special-occasions?hsLang=en#main-content)

    - [Creating and Managing Events](https://help.nowbookit.com/events-and-special-occasions?hsLang=en#creating-and-managing-events)
    - [Event Scheduling](https://help.nowbookit.com/events-and-special-occasions?hsLang=en#event-scheduling)
- [Sadie and Integrations](https://help.nowbookit.com/sadie-and-integrations?hsLang=en#main-content)

    - [Sadie (AI Assistant)](https://help.nowbookit.com/sadie-and-integrations?hsLang=en#sadie-ai-assistant)
    - [POS Integrations](https://help.nowbookit.com/sadie-and-integrations?hsLang=en#pos-integrations)
    - [Payment Gateways](https://help.nowbookit.com/sadie-and-integrations?hsLang=en#payment-gateways)
    - [Google / Facebook](https://help.nowbookit.com/sadie-and-integrations?hsLang=en#google-facebook)
    - [Partner Integrations](https://help.nowbookit.com/sadie-and-integrations?hsLang=en#partner-integrations)
- [Payments and Gift Cards](https://help.nowbookit.com/payments-and-gift-cards?hsLang=en#main-content)

    - [Gift Cards](https://help.nowbookit.com/payments-and-gift-cards?hsLang=en#gift-cards)
    - [Payments and Refunds](https://help.nowbookit.com/payments-and-gift-cards?hsLang=en#payments-and-refunds)
- [Configuration and Communication](https://help.nowbookit.com/configuration-and-communication?hsLang=en#main-content)

    - [Venue Settings](https://help.nowbookit.com/configuration-and-communication?hsLang=en#venue-settings)
    - [Email and Communications](https://help.nowbookit.com/configuration-and-communication?hsLang=en#email-and-communications)
    - [Booking Customisation](https://help.nowbookit.com/configuration-and-communication?hsLang=en#booking-customisation)
    - [Booking Widget Customisation](https://help.nowbookit.com/configuration-and-communication?hsLang=en#booking-widget-customisation)
    - [CRM](https://help.nowbookit.com/configuration-and-communication?hsLang=en#crm)
- [NBI Booking Analytics](https://help.nowbookit.com/nbi-booking-analytics?hsLang=en#main-content)

    - [Payments](https://help.nowbookit.com/nbi-booking-analytics?hsLang=en#payments)
    - [Bookings & Service](https://help.nowbookit.com/nbi-booking-analytics?hsLang=en#bookings-service)
    - [Getting Started](https://help.nowbookit.com/nbi-booking-analytics?hsLang=en#getting-started)

[![KBlogo](https://help.nowbookit.com/hs-fs/hubfs/KBlogo.png?width=200&height=50&name=KBlogo.png "KBlogo")](https://nowbookit.com)

Need more assistance? Speak to a team member over the phone.

- Australia: [1800 265 726](tel:1800265726)
- New Zealand: [0800 453 933](tel:0800453933)
- United States: [1 469 458 6874](tel:14694586874)
- Canada: [1 438 794 9945](tel:14387949945)
- International: [+61 2 7912 1576](tel:61279121576)

<https://www.facebook.com/nowbookitNBI> <https://www.instagram.com/@now_book_it> <https://www.linkedin.com/company/now-book-it> <https://www.youtube.com/@NowBookIt> [mailto:enquiries@nowbookit.com](mailto:enquiries@nowbookit.com)

 

[nowbookit.com](https://www.nowbookit.com/)

Copyright © 2026, Now Book It