---
title: Custom Order Status Email Placeholders Reference
description: Every placeholder you can use in custom WooCommerce order status emails, and where each one works. Pro.
url: "https://wpfactory.com/docs/woocommerce-order-status-email-placeholders/"
updated: "2026-09-27"
category: References
---

# Custom Order Status Email Placeholders Reference

This reference lists every placeholder available in the Pro status emails of [Additional Custom Order Status for WooCommerce](https://wpfactory.com/item/order-status-for-woocommerce/), and where each one works.

### Subject, heading, and content placeholders

These placeholders work in the email **subject**, **heading**, and **content**:

| Placeholder | Replaced with |
| --- | --- |
| `{order_id}` | Internal order ID. |
| `{order_number}` | Order number shown to the customer. |
| `{order_date}` | Order creation date, in your site date format. |
| `{order_billing_first_name}` | Billing first name. |
| `{order_billing_last_name}` | Billing last name. |
| `{order_pay_url}` | The customer pay-for-order URL. Added in version 1.9.3. |
| `{site_title}` | Your site title. |
| `{status_to}` | Slug of the new status. |
| `{status_to_title}` | Title of the new status. |
| `{status_from}` | Slug of the previous status. |
| `{status_from_title}` | Title of the previous status. |

### Heading and content only

| Placeholder | Replaced with |
| --- | --- |
| `{order_details}` | The WooCommerce order items table. |
| `{completed_order}` | The full WooCommerce completed-order email block. |

### Recipient (email address) placeholders

These work only in the **Email address** field, and use percent signs, not curly braces:

| Placeholder | Replaced with |
| --- | --- |
| `%customer%` | The order's billing email address. |
| `%admin%` | Your site's admin email address. |

**Note:** to insert an order meta value, use the `[alg_wc_os_order_meta key="..."]` shortcode in the content field. There is no `{custom_field_...}` placeholder.

### Put these to work

Placeholders are used in Pro status emails. See how to [send automated emails on status change](https://wpfactory.com/item/order-status-for-woocommerce/), or [get Custom Order Status Pro](https://wpfactory.com/item/order-status-for-woocommerce/).

Related articles

- [Configuring Custom Order Status Emails](https://wpfactory.com/docs/email-and-sms-configures/)
- [Send WooCommerce Emails on Custom Order Status Change](https://wpfactory.com/docs/proactive-email-setup/)
- [The Order Meta Shortcode for Status Emails](https://wpfactory.com/docs/woocommerce-order-status-order-meta-shortcode/)
- [Deleting a Custom Order Status Safely](https://wpfactory.com/docs/woocommerce-delete-order-status-fallback/)
- [Custom Order Status: Free vs Pro Versions Compared](https://wpfactory.com/docs/difference-between-pro-and-free-version/)