# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.loopit.co/settings/email-templates/merge-tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.