> For the complete documentation index, see [llms.txt](https://docs.loopit.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.loopit.co/settings/email-templates/merge-tags.md).

# Merge Tags

Merge tags are the substitutions available to you when designing an email template. Depending on the entity model being given to an email template, you might see different fields available. Here's all the merge tags you have available to you.

## Location Fields

<table data-full-width="true"><thead><tr><th width="306">Name</th><th width="153">Entity Type Supported</th><th>Example</th></tr></thead><tbody><tr><td>location_name</td><td>Booking, Invoice, Payment</td><td>Acme Inc - Exampletown</td></tr><tr><td>location_email</td><td>Booking, Invoice</td><td>acme@example.com</td></tr><tr><td>location_phone</td><td>Booking, Invoice</td><td>0123456789</td></tr><tr><td>location_website</td><td>Booking, Invoice</td><td>www.example.com</td></tr><tr><td>location_full_address</td><td>Booking, Invoice</td><td>1 Test St, Apt #13, Exampletown, CA, 90022, United States</td></tr><tr><td>location_address_line_1</td><td>Booking, Invoice</td><td>1 Test St</td></tr><tr><td>location_address_line_2</td><td>Booking, Invoice</td><td>Apt #13</td></tr><tr><td>location_city</td><td>Booking, Invoice</td><td>Exampletown</td></tr><tr><td>location_state</td><td>Booking, Invoice</td><td>CA</td></tr><tr><td>location_postcode</td><td>Booking, Invoice</td><td>90022</td></tr><tr><td>location_country</td><td>Booking, Invoice</td><td>United States</td></tr><tr><td>pickup_location_name</td><td>Booking</td><td>Acme Inc - Exampletown</td></tr><tr><td>pickup_location_email</td><td>Booking</td><td>acme@example.com</td></tr><tr><td>pickup_location_phone</td><td>Booking</td><td>0123456789</td></tr><tr><td>pickup_location_website</td><td>Booking</td><td>www.example.com</td></tr><tr><td>pickup_location_full_address</td><td>Booking</td><td>1 Test St, Apt #13, Exampletown, CA, 90022, United States</td></tr><tr><td>pickup_location_address_line_1</td><td>Booking</td><td>1 Test St</td></tr><tr><td>pickup_location_address_line_2</td><td>Booking</td><td>Apt #13</td></tr><tr><td>pickup_location_city</td><td>Booking</td><td>Exampletown</td></tr><tr><td>pickup_location_state</td><td>Booking</td><td>CA</td></tr><tr><td>pickup_location_postcode</td><td>Booking</td><td>90022</td></tr><tr><td>pickup_location_country</td><td>Booking</td><td>United States</td></tr><tr><td>dropoff_location_name</td><td>Booking</td><td>Acme Inc - Exampletown</td></tr><tr><td>dropoff_location_email</td><td>Booking</td><td>acme@example.com</td></tr><tr><td>dropoff_location_phone</td><td>Booking</td><td>0123456789</td></tr><tr><td>dropoff_location_website</td><td>Booking</td><td>www.example.com</td></tr><tr><td>dropoff_location_full_address</td><td>Booking</td><td>1 Test St, Apt #13, Exampletown, CA, 90022, United States</td></tr><tr><td>dropoff_location_address_line_1</td><td>Booking</td><td>1 Test St</td></tr><tr><td>dropoff_location_address_line_2</td><td>Booking</td><td>Apt #13</td></tr><tr><td>dropoff_location_city</td><td>Booking</td><td>Exampletown</td></tr><tr><td>dropoff_location_state</td><td>Booking</td><td>CA</td></tr><tr><td>dropoff_location_postcode</td><td>Booking</td><td>90022</td></tr><tr><td>dropoff_location_country</td><td>Booking</td><td>United States</td></tr></tbody></table>

## Invoice Fields

<table data-full-width="true"><thead><tr><th>Name</th><th>Entity Type Supported</th><th>Example</th></tr></thead><tbody><tr><td>invoice_number</td><td>Invoice, Payment</td><td>INV123456</td></tr><tr><td>invoice_due_date</td><td>Invoice, Payment</td><td>21st Sept, 2025</td></tr><tr><td>invoice_outstanding_balance</td><td>Invoice</td><td>$123.45</td></tr><tr><td>invoice_surcharge_amount</td><td>Invoice</td><td>$1.25</td></tr><tr><td>invoice_surcharge_rate</td><td>Invoice</td><td>2%</td></tr><tr><td>invoice_service_period_start_date</td><td>Invoice</td><td>21st Sept, 2025</td></tr><tr><td>invoice_service_period_end_date</td><td>Invoice</td><td>22nd Sept, 2025</td></tr><tr><td>payment_charge_at</td><td>Payment</td><td>Wed, 18 Dec 02:36 pm AEDT/ No further attempt scheduled</td></tr><tr><td>payment_attempts</td><td>Invoice</td><td>Number of <em>automated</em> attempts made for payment. </td></tr></tbody></table>

## Person/Company Fields

For people and companies, we still use the same field names, however, the values change. This is to make it easy to write one email template for both types.

<table data-full-width="true"><thead><tr><th width="283">Name</th><th>Entity Type Supported</th><th>Person Example</th><th>Company Example</th></tr></thead><tbody><tr><td>payer_first_name</td><td>Booking, Invoice, Refund, CreditNote</td><td>John</td><td>Acme Inc</td></tr><tr><td>payer_middle_name</td><td>Booking, Invoice, Refund, CreditNote</td><td>Lewis</td><td><em>&#x3C;blank></em></td></tr><tr><td>payer_last_name</td><td>Booking, Invoice,  Refund, CreditNote</td><td>Smith</td><td><em>&#x3C;blank></em></td></tr><tr><td>payer_full_name</td><td>Booking, Invoice,  Refund, CreditNote</td><td>John Lewis Smith</td><td>Acme Inc</td></tr><tr><td>payer_email</td><td>Booking</td><td>test@test.com</td><td>test@test.com</td></tr><tr><td>owner_first_name</td><td>Booking, Payment, Document</td><td>John</td><td>Acme Inc</td></tr><tr><td>owner_middle_name</td><td>Booking, Payment, Document</td><td>Lewis</td><td><em>&#x3C;blank></em></td></tr><tr><td>owner_last_name</td><td>Booking, Payment, Document</td><td>Smith</td><td><em>&#x3C;blank></em></td></tr><tr><td>owner_full_name</td><td>Booking, Payment, Document</td><td>John Lewis Smith</td><td>Acme Inc</td></tr><tr><td>owner_email</td><td>Booking</td><td>test@test.com</td><td>test@test.com</td></tr><tr><td>owner_phone</td><td>Booking</td><td>012345678</td><td>012345678</td></tr><tr><td>primary_driver_first_name</td><td>Booking</td><td>John</td><td><em>&#x3C;N/A></em></td></tr><tr><td>primary_driver_middle_name</td><td>Booking</td><td>Lewis</td><td><em>&#x3C;N/A></em></td></tr><tr><td>primary_driver_last_name</td><td>Booking</td><td>Smith</td><td><em>&#x3C;N/A></em></td></tr><tr><td>primary_driver_full_name</td><td>Booking</td><td>John Lewis Smith</td><td><em>&#x3C;N/A></em></td></tr></tbody></table>

## Asset Fields

<table data-full-width="true"><thead><tr><th>Name</th><th>Entity Type Supported</th><th>Example</th></tr></thead><tbody><tr><td>asset_name</td><td>Asset, Booking</td><td>Ford F-150 Lariat</td></tr><tr><td>asset_year</td><td>Asset, Booking</td><td>2023</td></tr><tr><td>asset_make</td><td>Asset, Booking</td><td>Ford</td></tr><tr><td>asset_model</td><td>Asset, Booking</td><td>F-150</td></tr><tr><td>asset_trim</td><td>Asset, Booking</td><td>Lariat</td></tr><tr><td>asset_licence_plate</td><td>Asset, Booking</td><td>ABC123</td></tr><tr><td>asset_category_name</td><td>Asset, Booking</td><td>Sedan</td></tr><tr><td>asset_color</td><td>Asset, Booking</td><td>Red</td></tr><tr><td>asset_condition</td><td>Asset, Booking</td><td>Used</td></tr><tr><td>asset_registration_state</td><td>Asset, Booking</td><td>NSW</td></tr><tr><td>asset_stock_number</td><td>Asset, Booking</td><td>XH123</td></tr><tr><td>asset_vin</td><td>Asset, Booking</td><td>2299DDDHH3334</td></tr><tr><td>asset_fuel_type</td><td>Asset, Booking</td><td>Electric</td></tr></tbody></table>

## Package Fields

<table data-full-width="true"><thead><tr><th>Name</th><th>Entity Type Supported</th><th>Example</th></tr></thead><tbody><tr><td>package_name</td><td>Booking</td><td>Rental</td></tr></tbody></table>

## Booking Fields

<table data-full-width="true"><thead><tr><th>Name</th><th>Entity Type Supported</th><th>Example</th></tr></thead><tbody><tr><td>booking_number</td><td>Booking</td><td>B000022</td></tr><tr><td>platform_link</td><td>Booking</td><td>Link to booking in platform</td></tr><tr><td>billing_frequency</td><td>Booking</td><td>Weekly</td></tr><tr><td>start_date</td><td>Booking</td><td>21st Sept, 2025</td></tr><tr><td>start_time</td><td>Booking</td><td>9:50 AM</td></tr><tr><td>end_date</td><td>Booking</td><td>28th Sept, 2025</td></tr><tr><td>end_time</td><td>Booking</td><td>9:50 AM</td></tr><tr><td>program_type_name</td><td>Booking</td><td>Rental/Subscription</td></tr><tr><td>next_invoice_date</td><td>Booking</td><td>21st Sept, 2025</td></tr><tr><td>payment_method_last_4_digits</td><td>Booking</td><td>1234</td></tr><tr><td>payment_method_type</td><td>Booking</td><td>Card, BECS Direct Debit, etc</td></tr><tr><td>payment_method_brand</td><td>Booking</td><td>Visa, Mastercard</td></tr><tr><td>booking_reference</td><td>Booking</td><td>XY123</td></tr></tbody></table>

## Refund Fields

<table data-full-width="true"><thead><tr><th>Name</th><th>Entity Type Supported</th><th>Example</th></tr></thead><tbody><tr><td>refund_amount</td><td>Refund</td><td>$100.00</td></tr><tr><td>transaction_id</td><td>Refund</td><td>EX1234567890</td></tr></tbody></table>

## CreditNote Fields

<table data-full-width="true"><thead><tr><th>Name</th><th>Entity Type Supported</th><th>Example</th></tr></thead><tbody><tr><td>credit_note_number</td><td>CreditNote</td><td>CN123456</td></tr><tr><td>credit_note_type</td><td>CreditNote</td><td>Adjustment/Refundable</td></tr><tr><td>credit_note_amount</td><td>CreditNote</td><td>$100.00</td></tr></tbody></table>

## Contract Fields

<table data-full-width="true"><thead><tr><th>Name</th><th>Entity Type Supported</th><th>Example</th></tr></thead><tbody><tr><td>program_type_name</td><td>Contract</td><td>Rental/Subscription</td></tr><tr><td>view_sign_agreement_url</td><td>Contract</td><td>https://example.com/signature/agreement/123</td></tr></tbody></table>

## PaymentMethod  Fields

<table data-full-width="true"><thead><tr><th>Name</th><th>Entity Type Supported</th><th>Example</th></tr></thead><tbody><tr><td>card_brand</td><td>Payment</td><td>Visa/Master</td></tr><tr><td>card_last_4_digits</td><td>Payment</td><td>xxxx-xxxx-xxxx-1234</td></tr></tbody></table>

## Document  Fields

<table data-full-width="true"><thead><tr><th>Name</th><th>Entity Type Supported</th><th>Example</th></tr></thead><tbody><tr><td>document_type</td><td>Document</td><td>License/Passport/Insurance</td></tr><tr><td>document_number</td><td>Document</td><td>12345678</td></tr><tr><td>days_remaining_text</td><td>Document</td><td>expiring in 30 days, expring in 14 days, expring in 7 days, expired today</td></tr><tr><td>workspace_name</td><td>Document</td><td>xyz</td></tr></tbody></table>