When a customer adds a booking to the cart, BookThatApp (BTA) sends the booking details to Shopify as line item properties. These properties appear on the order, and they’re available to any app or email platform connected to your store, such as Klaviyo or other email marketing tools.
This article explains which properties BTA sends, and how to reference them in your emails without them breaking.
⚠️ Reference properties by name, not by position
The order and number of properties can change between orders and between app releases. Some properties only appear in certain situations (for example, only when a deposit is paid), so their position shifts depending on the booking.
If your email templates or automations reference properties by their position (for example, “the third property”), they may show the wrong information or break entirely. Always reference properties by name (for example, Date or Time).
🔒 Hide internal properties from emails
Properties that start with an underscore (_) are internal. BTA uses them to track booking metadata, and they aren’t meant for customers. Shopify keeps them off the checkout page, but email platforms may pull them into your templates.
To avoid showing internal metadata in customer emails, set your template or automation to exclude every property that starts with _.
📋 Properties BTA sends
Properties are listed in the order they’re currently sent. Items marked with a condition only appear when that condition applies. This order may change in future releases, which is why we recommend referencing properties by name.
| Property | When it appears |
|---|---|
| Date | Always |
_date_iso8601 | Always |
| Time | When applicable |
| Location | When applicable |
| Term | When applicable |
_start_iso8601 | Always |
_finish_iso8601 | Always |
| Resource | When the resource is visible and applicable |
_resource_ids | When applicable |
| Units | When applicable |
_bta_variant | Always |
_addons_uuid | Always |
_resource | When the resource is hidden and applicable |
_product_id | When paying a deposit |
_variant_id | When paying a deposit |
_product_has_security_bond | When applicable |
| product | When paying a deposit |
| Grand Total | When paying a deposit |
| Deposit Due Today | When paying a deposit |
| Booking field answers | In the order configured in the app |
| Encoding marker | When applicable |
| File properties | When applicable |
❓ FAQ
My email template stopped showing the right booking details. What changed?
The property order changed with the AI Bookings release. If your template references properties by position, update it to reference them by name.
Can I change the order of the properties?
No, except for booking field answers, which follow the order you’ve configured in the app.
Why do I see properties starting with an underscore in my emails?
These are internal properties. Exclude any property starting with _ in your email platform.
Comments
0 comments
Please sign in to leave a comment.