HarperShopify

Updated order tags for your Shopify store

We've made some changes to the way Harper tags orders in your Shopify store. This document explains what's new, what's changing, and what your team needs to do to move over to the new and improved format.

Do you need to take action?

Harper tags in Shopify

Harper order tags appear in the Tags panel (bottom right) on each order detail page in your Shopify admin. They update automatically throughout the order lifecycle and can be used as filters when generating reports or managing order lists.

The new tag structure

All new tags use a consistent hrp/ prefix. Tags are grouped into three types: service (hrp/service/), order status (hrp/status/) and payment status (hrp/payments/).

Top-level tag

Present on every Harper order.

Harper

Order placed using a Harper service

Service type tags

Present on every Harper order — identifies which service was used.

hrp/service/try

Order placed using the Try service

hrp/service/concierge

Order placed using the Concierge service

Concierge service status tags

One status tag appears at a time and updates as the order progresses.

hrp/status/new

Order placed but appointment has not yet happened

hrp/status/awaiting_returns

Appointment conducted — items expected back at warehouse

hrp/status/trial_ended

All items returned or purchased

hrp/status/cancelled

Order cancelled


Appointment information tag

hrp/appointment/YYYY.MM.DD/HH:MM

Appointment date and time

Try service status tags

One status tag appears at a time and updates as the order progresses.

hrp/status/new

Order placed but not yet received by customer

hrp/status/in_trial

Order received — try-on period active

hrp/status/trial_ended

All items returned or purchased

hrp/status/cancelled

Order cancelled


Additional Try tags

hrp/awaiting_returns

Items expected back at warehouse

hrp/dispute

Order is in Harper payment recovery flow

hrp/unrecovered

Payment unrecovered

Finance & payments tags

New tags giving finance and operations teams a clearer view of each order's financial position — including a dedicated flag when an order is ready to reconcile.

hrp/payments/customer_awaiting_items

Order placed but not yet received by customer

hrp/payments/in_fitting_room

Order received — try-on period active

hrp/payments/available

Part of order purchased — awaiting warehouse confirmation for remainder

hrp/payments/reconcilable

All items purchased or processed at warehouse


Exception tags

Applied when payment is paused to avoid incorrectly charging a customer.

hrp/payments/hold/warehouse_refund_due

Returns received but not yet processed at warehouse

hrp/payments/hold/pending_harper

Order placed on hold by Harper

Analytics tags

hrp/<checkout_id>

Harper checkout ID for matching to GA4 or other analytics

Tag scenario examples

Example 1

A Harper Try order currently in trial:

Top levelHarper
Servicehrp/service/try
Statushrp/status/in_trial
Paymenthrp/payments/in_fitting_room

Example 2

A completed Harper Try order:

Top levelHarper
Servicehrp/service/try
Statushrp/status/trial_ended
Paymenthrp/payments/reconcilable

Example 3

A Try order where items are returned but not yet processed at warehouse:

Top levelHarper
Servicehrp/service/try
Statushrp/status/trial_ended | hrp/awaiting_returns
Paymenthrp/payments/available | hrp/payments/hold/warehouse_refund_due

Tags your team may need to update

If your team filters on the tags below, you will need to update your logic to refer to the new equivilent tag.

The following tags will stop being applied after 1 June 2026.

harper:try

Now: hrp/service/try

harper:concierge

Now: hrp/service/concierge

harper_try:new

Now: hrp/status/new

harper_try:trial

Now: hrp/status/in_trial

harper_try:paid

Now: hrp/payments/available

harper_try:complete

Now: hrp/payments/reconcilable

harper_try:cancelled

Now: hrp/status/cancelled