Rule Selectors
Most app features work on a rule-based system: You select conditions so that when the rule's conditions match the Shopify order data, the rule triggers.
Each condition has a category, selector, and match value. Selectors that only appear in one Order Automation rule type are marked (tag rule only) or (fulfill rule only).
Order Automations
Product
product assigned location: Which fulfillment location the line item is assigned to in the order.
product collection: Checks all collections the products belong to and matches based on the collection name.
product inventory available: Checks the combined inventory available of the product across all locations. Products set to not track inventory are ignored.
product inventory at location: Checks the available inventory at the location assigned in the order. Products set to not track inventory are ignored.
product inventory at new location (fulfill rule only): Checks the inventory available of the item at the location you select for the fulfillment action. Products set to not track inventory are ignored.
product line item properties: Custom info added to the product (by apps or theme code) before the order is placed. You can see line item properties under the line item on the order details page.
product price (tag rule only): The price of the variant ordered.
product purchase option (tag rule only): Checks the product's purchase option, commonly used for subscription products. These options are defined in the product admin page under Purchase options and show under the line item when present.
product quantity: Checks the quantity ordered of each line item.
product shipping: Checks whether the product is set to "Physical product" or digital in the product Shipping settings.
product sku: Checks the SKU of the variant ordered.
product tag: Checks the tags on the product at the time the order is processed.
product title: The name of the line item product.
product type: Checks the Type field in the product details page.
product variant metafield: Matches a variant metafield by namespace.key and value. Supports text comparisons (ex: custom.color equals blue) and numeric comparisons (ex: custom.weight is greater than 5000).
product variant title: The name of the line item variant. For example, if a Cool T-Shirt has variants Small, Medium, and Large, ordering Medium gives a variant title of Medium.
product vendor: Checks the Vendor field in the product details page.
Order
order additional details (tag rule only): Checks the Additional Details section of the order. This section only shows if additional details were added, usually by an app or custom theme code.
order billing country: Full name of the country in the order billing address. Example: United States.
order billing state: Full name of the state or province in the order billing address. Example: California.
order channel: Checks the name of the app or sales channel that created the order. You can find this at the top of the order details page. Common examples: Online Store, Draft Orders, Point of Sale, Shop.
order chargeback status (tag rule only): Checks the chargeback or dispute status of the order. Options: open, submitted, won, lost, prevented.
order delivery method: Checks how the order will be delivered. Options: pickup, shipping, local delivery, pickup point, retail, none.
order discount code: Checks the discount code applied to the order, or the discount name for automatic discounts. Use contains {any} to match orders with any discount.
order financial status: Checks the payment status of the order. Options include authorized, expired, paid, partially paid, partially refunded, and refunded.
order fraud analysis: Checks the risk level from Shopify's Fraud analysis section on the order (high risk, medium risk, or low risk).
order fulfillment status: Checks the order fulfillment status. Options: fulfilled, not fulfilled, on hold, partially fulfilled, unfulfilled.
order landing page (tag rule only): The first page on your site the customer landed on before placing the order. Use the Rule Tester to look up an order and find its landing page.
order metafield: Matches an order metafield by name and value from the Metafields card on the order details page. Use {any} to match when a metafield has any value.
order notes: Checks the Notes section of the order. Use contains {any} to match orders with any note, or does not contain {any} for orders with no notes.
order number of items: Counts the quantity of each line item and totals them to get the total number of units in the order.
order number of line items: Counts the number of line items, or number of different products, in the order.
order number of vendors: Counts the total number of unique vendors for the products in the order.
order payment gateway (tag rule only): Checks the payment gateway used for the order. Use the Rule Tester to find the exact gateway name. Common examples: shopify_payments, paypal, manual.
order payment method: Checks the payment method name on the order. Use the Rule Tester to find the exact name. Common examples: Visa, Mastercard, American Express, PayPal, Klarna.
order refund reason: Checks the reason or note entered when a refund is applied. If an order has multiple refunds, all refund reasons are checked.
order tag: Checks the tags on the order at the time it is processed. If you add tags manually after the order is created, set a delay on the Help page so you have time to add the tag before the rule runs.
order tax: Checks the total tax added to the order.
order tip (tag rule only): Identifies orders that have a tip from Shopify Checkout Tips. If you use an app to collect tips before checkout, use a product condition instead.
order total: The total price of all line items, discounts, shipping, taxes, and tips in your store's currency.
order tracking numbers: Checks how many tracking numbers the order has. Useful for identifying when tracking has been added after fulfillment.
order utm campaign first: Checks the UTM campaign from the customer's first visit before placing the order, from Conversion summary > Session details. Typically identifies the marketing campaign (ex: summer_sale).
order utm campaign last: Checks the UTM campaign from the customer's last visit before placing the order.
order utm medium first: Checks the UTM medium from the customer's first visit before placing the order. Typically identifies the marketing medium (ex: email, social, cpc).
order utm medium last: Checks the UTM medium from the customer's last visit before placing the order.
order utm source first: Checks the UTM source from the customer's first visit before placing the order. Typically identifies the traffic source (ex: google, facebook, newsletter).
order utm source last: Checks the UTM source from the customer's last visit before placing the order.
order weight: The sum of all line item weights in grams.
Shipping
shipping address (tag rule only): Matches the shipping address as a combined string (address, city, state, zip). Use contains No shipping address to tag Local Pickup orders with no shipping address.
shipping address validation: Checks whether Shopify shows a warning for shipping address issues on the order. Options: has issues, no issues.
shipping city: The name of the city in the shipping address.
shipping country: Full name of the country in the shipping address. Example: United States.
shipping method: Checks the shipping method name on the order details page (Standard, Express, etc.). For local pickup, use the order delivery method condition instead.
shipping price (tag rule only): Checks the price of the shipping method selected for the order.
shipping region: Checks whether the shipping country is in a region group. Currently supports EU (European Union countries).
shipping state: Full name of the state or province in the shipping address. Example: California.
shipping zip code: Checks the zip or postal code of the shipping address. Supports multiple codes separated by commas and starts with matching for regional prefixes.
Customer
customer creation date: The date the customer was created in your store, usually on their first order. Use date format yyyy-mm-dd.
customer email: Checks the email address on the customer account linked to the order.
customer language: The language the customer used when placing the order, usually represented as language plus region (ex: en-US, fr-CA). Use the Rule Tester to look up an order and find the customer's language.
customer orders: The customer's order count at the time the order is processed. Use {customer_orders} in the add tag action to include the count in the tag name.
customer previous order: Checks how long ago the customer's last order was. Enter a value like 2 hours or 7 days.
customer tag: Checks the tags on the customer account.
customer total spent (tag rule only): Checks the lifetime amount the customer has spent in your store.
Post Purchase Upsell
Post-purchase upsells use a smaller set of selectors. Shopify's post-purchase API exposes less order data than the thank-you page (ex: no discount codes, no full shipping address — only country code).
Product
product sku: Checks the SKU of the variant ordered.
product title: The name of the line item product.
product type: Checks the Type field in the product details page.
product variant title: The name of the line item variant.
product vendor: Checks the Vendor field in the product details page.
Order
order number of items: Counts the total quantity of all line items in the order.
order number of line items: Counts the number of different line items (products) in the order.
order total: The total price of all line items, discounts, shipping, taxes, and tips in your store's currency.
Shipping
shipping country code: The 2-character country code in the shipping address. Example: US for United States, CA for Canada, GB for United Kingdom.
Customer
customer language: The language the customer used when placing the order (ex: en-US, fr-CA).
Thank You Messages
Thank-you message rules use a limited selector set. These run on the thank-you page with data available client-side (no extra API calls).
Product
product sku: Checks the SKU of the variant ordered.
product title: The name of the line item product.
product type: Checks the Type field in the product details page.
product variant title: The name of the line item variant.
product vendor: Checks the Vendor field in the product details page.
Order
order discount code: Checks the discount code applied to the order, or the discount name for automatic discounts.
order total: The total price of all line items, discounts, shipping, taxes, and tips in your store's currency.
Shipping
shipping city: The name of the city in the shipping address.
shipping country code: The 2-character country code in the shipping address. Example: US for United States, CA for Canada.
shipping state code: The 2-character state or province code in the shipping address. Example: CA for California, TX for Texas.
Customer
customer language: The language the customer used when placing the order (ex: en-US, fr-CA).