Documentation

List of all available placeholders

List of all available placeholders#

Below are the placeholders provided by ShopMagic and the integrations listed on this page. Availability depends on the active plugins and the data supplied by the selected automation event.

Use the placeholder selector in the automation editor to check which placeholders are available for your event. Some require parameters, such as a metadata key, form field, or coupon template. The lists below show their base names; configure any required parameters before inserting them.

Explore the available ShopMagic add-ons.

ShopMagic core plugin#

Customer data#

  • {{ customer.company }}
  • {{ customer.email }}
  • {{ customer.first_name }}
  • {{ customer.last_name }}
  • {{ customer.name }}
  • {{ customer.phone }}
  • {{ customer.unsubscribe_url }}
  • {{ customer.username }}

Website data#

  • {{ shop.admin_email }}
  • {{ shop.tagline }}
  • {{ shop.title }}
  • {{ shop.url }}

WordPress post data#

These placeholders require post data from the selected event.

  • {{ post.author }}
  • {{ post.content }}
  • {{ post.date }}
  • {{ post.excerpt }}
  • {{ post.id }}
  • {{ post.link }}
  • {{ post.modified_date }}
  • {{ post.slug }}
  • {{ post.status }}
  • {{ post.title }}
  • {{ post.type }}

WooCommerce order data#

These placeholders require WooCommerce and order data from the selected event.

  • {{ order.admin_url }}
  • {{ order.cross_sells }}
  • {{ order.customer_id }}
  • {{ order.customer_note }}
  • {{ order.date_completed }}
  • {{ order.date_created }}
  • {{ order.date_paid }}
  • {{ order.details }}
  • {{ order.downloads }}
  • {{ order.id }}
  • {{ order.meta }}
  • {{ order.order_number }}
  • {{ order.payment_method }}
  • {{ order.payment_url }}
  • {{ order.products_ordered }}
  • {{ order.products_sku }}
  • {{ order.quantity_products }}
  • {{ order.related_products }}
  • {{ order.status }}
  • {{ order.total }}

{{ order.id }} returns the internal order ID. Use {{ order.order_number }} for the customer-facing number, which may differ when custom order numbering is enabled.

Order billing data#

  • {{ order.billing_address }}
  • {{ order.billing_address_2 }}
  • {{ order.billing_city }}
  • {{ order.billing_company }}
  • {{ order.billing_country }}
  • {{ order.billing_email }}
  • {{ order.billing_first_name }}
  • {{ order.billing_formatted_address }}
  • {{ order.billing_last_name }}
  • {{ order.billing_phone }}
  • {{ order.billing_postcode }}
  • {{ order.billing_state }}

Order shipping data#

  • {{ order.shipping_address }}
  • {{ order.shipping_address_2 }}
  • {{ order.shipping_city }}
  • {{ order.shipping_company }}
  • {{ order.shipping_country }}
  • {{ order.shipping_first_name }}
  • {{ order.shipping_formatted_address }}
  • {{ order.shipping_last_name }}
  • {{ order.shipping_method }}
  • {{ order.shipping_phone }}
  • {{ order.shipping_postcode }}
  • {{ order.shipping_state }}

Order note data#

These placeholders require an event that supplies the order note, such as Order Note Added.

  • {{ order_note.author }}
  • {{ order_note.content }}

WooCommerce product data#

These placeholders are included in the core plugin's WooCommerce integration. They require product data from the event; they do not automatically select a product from an order containing multiple items.

  • {{ product.desc }}
  • {{ product.id }}
  • {{ product.link }}
  • {{ product.meta }}
  • {{ product.name }}
  • {{ product.price }}
  • {{ product.regular_price }}
  • {{ product.sale_price }}
  • {{ product.short_desc }}
  • {{ product.sku }}

ShopMagic Abandoned Carts#

Requires the Abandoned Carts add-on and cart data from the event.

  • {{ cart.item_count }}
  • {{ cart.items }}
  • {{ cart.link }}
  • {{ cart.total }}

ShopMagic for Contact Form 7#

Requires the Contact Form 7 integration and form submission data.

  • {{ form.entry_email }}
  • {{ form.entry_field }}
  • {{ form.form_id }}

For {{ form.entry_field }}, set the Entry field parameter to the Contact Form 7 field name, such as your-email.

{{ customer.email }} is a core placeholder. It can also be used when the event supplies customer data.

ShopMagic Review Requests#

  • {{ order.products_ordered_links }}
  • {{ order.products_ordered_review_links }}
  • {{ review.content }}
  • {{ review.rating }}

Use the order placeholders to include product links or review links in order-based messages. The review.* placeholders display data from an existing review and require review data, such as that provided by Review Published.

Product placeholders such as {{ product.id }}, {{ product.link }}, {{ product.name }}, and {{ product.meta }} belong to the core plugin and are available when product data is supplied.

ShopMagic Customer Coupons#

  • {{ order.coupons }}
  • {{ shop.coupon }}

{{ order.coupons }} displays coupon codes used in the order. {{ shop.coupon }} generates a new coupon and requires a coupon template.

ShopMagic for Gravity Forms#

Requires the Gravity Forms integration and form submission data.

  • {{ form.entry_id }}
  • {{ form.entry_email }}
  • {{ form.entry_field }}
  • {{ form.form_id }}

For {{ form.entry_field }}, set the Form field parameter to the numeric Gravity Forms field ID.

Legacy Gravity Forms names#

The following names remain registered for backward compatibility. Use the form.* names above in new automations.

  • {{ gravity_form.entry_id }}
  • {{ gravity_form.entry_email }}
  • {{ gravity_form.entry_field }}
  • {{ gravity_form.form_id }}

ShopMagic for WooCommerce Memberships#

Requires WooCommerce Memberships and its ShopMagic integration. Availability depends on the membership or customer data supplied by the event.

  • {{ customer.membership_profile_field }}
  • {{ membership.expires_date }}
  • {{ membership.id }}
  • {{ membership.meta }}
  • {{ membership.plan_id }}
  • {{ membership.plan_name }}
  • {{ membership.renewal_url }}
  • {{ membership.started_date }}
  • {{ membership.status }}

ShopMagic for WooCommerce Subscriptions#

Requires WooCommerce Subscriptions and its ShopMagic integration. The correct prefix is subscription., in the singular.

  • {{ order.type }}
  • {{ subscription.admin_url }}
  • {{ subscription.billing_address }}
  • {{ subscription.change_payment_method_url }}
  • {{ subscription.early_renewal_url }}
  • {{ subscription.end_date }}
  • {{ subscription.id }}
  • {{ subscription.items }}
  • {{ subscription.last_payment_date }}
  • {{ subscription.meta }}
  • {{ subscription.next_payment_date }}
  • {{ subscription.payment_count }}
  • {{ subscription.payment_method }}
  • {{ subscription.shipping_address }}
  • {{ subscription.start_date }}
  • {{ subscription.status }}
  • {{ subscription.total }}
  • {{ subscription.trial_end_date }}
  • {{ subscription.view_url }}

{{ order.type }} identifies the order's relationship to a subscription. The subscription.* placeholders require subscription data.

ShopMagic for WooCommerce Bookings#

Requires WooCommerce Bookings and its ShopMagic integration, together with booking data from the event.

  • {{ booking.cost }}
  • {{ booking.end_date }}
  • {{ booking.id }}
  • {{ booking.meta }}
  • {{ booking.people }}
  • {{ booking.product }}
  • {{ booking.resource }}
  • {{ booking.start_date }}
  • {{ booking.status }}

Additional integrations included in ShopMagic#

Flexible Checkout Fields#

  • {{ order.checkout_field }}

Available when the compatible Flexible Checkout Fields integration is initialized. Select the checkout field using the placeholder's Field name parameter.

Flexible Shipping shipment tracking#

  • {{ order.shipment_tracking_links }}

Available when the Flexible Shipping shipment integration is present. It displays tracking links supplied by shipments associated with the order.

Why a placeholder may be unavailable or empty#

Installing an add-on does not make its data available to every event. For example, a customer-only event may not provide an order, product, subscription, or booking.

If a placeholder is missing from the selector or produces no useful value, check the selected event, required plugins, placeholder parameters, and the underlying record. Some placeholders generate formatted HTML, so choose an appropriate output format for plain text emails, SMS messages, or spreadsheet cells.

Not the solution you are looking for?

Please check other articles or open a support ticket.