What information can I insert?
| Variable | Content | Where it works |
|---|---|---|
| {{first_name}} / {{last_name}} / {{full_name}} | Buyer's first name / last name / full name | All pages (only for buyers linked to customer information) |
| {{orders_count}} | Number of past orders (not including the current order) | All pages |
| {{orders_count_next}} | Which number purchase this is | All pages |
| {{order_number}} | Order number | Thank you page, order status page |
| {{subtotal}} | Order subtotal | Thank you page |
| {{metafield:namespace.key}} | Value of an imported customer metafield | All pages |
You can use variables in text headings and body text, coupon headings and descriptions, social link headings, and button labels. They can't be used in coupon codes, URLs, image alt text, or custom HTML blocks. If you write a variable in a custom HTML block, it is not replaced, and text like {{first_name}} appears as is. You can copy each variable with its copy button, such as 「{{first_name}} をコピー」 (Copy {{first_name}}), in 「使える変数」 (Available variables) on the 「変数設定」 (Variable settings) screen (Pro plan only).
Text variables are a Pro plan feature. On the Free and Basic plans, variables are not replaced and display the same as when there is no value.
Things to know when using metafields
Customer metafields are extra fields you can store with customer information. You specify them in the form "group name.field name", such as "custom.nickname" (shown as namespace.key on screens and in descriptions). To register the metafields you want to use, go to 「メタフィールド取り込み」 (Metafield import) on the app's 「変数設定」 (Variable settings) screen, enter each key to import in namespace.key format, one per line, and click 「設定を保存」 (Save settings). Then insert it into text as {{metafield:namespace.key}}. You can register up to 10 keys. Metafield import can only be set up on the 「変数設定」 (Variable settings) screen. Values are treated as text, and anything beyond 200 characters is not shown.
After you register a key, new orders and customer information updates are reflected automatically. To reflect values for customers who existed before you registered the key, click 「同期を開始」 (Start sync) or 「再実行」 (Run again) under 「既存顧客の同期（バックフィル）」 (Sync existing customers, backfill) on the 「変数設定」 (Variable settings) screen. Before going live, check your text with both customers who have a value and customers who don't.
How do I write text that works even without a value?
If you add "|" and some text after the variable name, that text is shown when there is no value. For example, 「{{last_name|お客}}様」 shows 「お客様」 (Dear customer) when there is no value. A variable without "|" is left blank when there is no value.
Text that reads awkwardly without a name, such as 「{{last_name}}様だけのご案内です」 (A special offer just for {{last_name}}).
Text that specifies what to show when there is no value, such as 「{{last_name|お客}}様、ご購入ありがとうございます」 (Thank you for your purchase, Mr./Ms. [last name], or "Dear customer" when there is no value).
The following are treated as having no value: guest checkouts, customers not yet synced, and the order number and subtotal on customer account pages. Right after switching to the Pro plan, name and order count variables are treated as having no value until you run the sync of existing customers.