Triggers & Filters

Order Triggers
Order triggers are the rules that tell Smart Order Notifications to send a notification for a given order or to include the order in a batch. The triggers are used to analyse properties of an order and determine if they qualify as a match or not. The following order properties can be used to trigger a notification but we're adding new triggers all the time so if you have a suggest, please just ask.
Order Field
Description
Order source
This is the value Shopify uses to determine which Shopify sales channel created the order. Possible values include:

web : Shopify Online Store
pos : Shopify Point of Sale
shopify_draft_order: Draft Order
iphone : Shopify iOS app
android : Shopify Android app
Order tag
Tags applied to the order in the Shopify admin or by other apps. Value for this trigger is case sensitive and matches one tag only. If you want to match multiple tags, please add multiple triggers.
Order shipping address country
Destination country matches on the country of the order's shipping address. This allows for triggers based on the region the customer is sending their order to. A dropdown list of countries is provided in the app configuration interface.
Order shipping address city
Destination city matches on the city of the order's shipping address. This allows for triggers based on the town or city the customer is sending their order to. 
Order shipping address province
Destination province triggers based on the orders shipping province and allows you to trigger notifications based on state and county. Whilst Shopify do not publish a list of their provinces, looking at an order for a given province will provide you with the formatting. For example New York or Wiltshire.
Order shipping address postal code
This allows you to trigger notifications based on the postal or zip code on the order. Note: we do not currently support postal code ranges, so to achieve ranges it's necessary to use the contains operator or to list every postal code in the range as separate triggers.
Order billing address country
Billing country matches on the country of the order's billing address. This allows for triggers based on the region the customer is sending their order to. A dropdown list of countries is provided in the app configuration interface.
Order billing address city
Billing city matches on the city of the order's billing address. This allows for triggers based on the town or city the customer is sending their order to. 
Order billing address province
Billing province triggers based on the orders billing province and allows you to trigger notifications based on state and county. Whilst Shopify do not publish a list of their provinces, looking at an order for a given province will provide you with the formatting. For example New York or Somerset.
Order billing address postal code
This allows you to trigger notifications based on the billing postal or zip code on the order. Note: we do not currently support postal code ranges, so to achieve ranges it's necessary to use the contains operator or to list every postal code in the range as separate triggers.
Order cancelled
Trigger a notification based on if the order is cancelled or not. Possible values: 
true: the order is cancelled 
false: the order is not cancelled 
Order shipping method
Match orders based on the name of the shipping method. Would be as configured in your Shopify shipping settings or your third party carrier service. This field is also useful for triggering based on pick-up location where the shipping method is the name of the location as setup in Shopify.
Order total
The total value of the order. This is the sum of all line item prices, discounts, shipping, taxes, and tips in the shop currency.
Order financial status
The current financial status of an order. This allows you to trigger notifications based on if an order is pending payment or only when paid. Possible values include:

authorized: Show only authorized orders
pending: Show only pending orders
paid: Show only paid orders
partially_paid: Show only partially paid orders
refunded: Show only refunded orders
voided: Show only voided orders
partially_refunded: Show only partially refunded orders
unpaid: Show authorized and partially paid orders.
Order attribute
Order attributes are often used to add additional information to an order in the cart or, on Plus stores, in the checkout. Attributes consist of a key value pair for example :"gift-note":"Happy Birthday, James!". When configuring your notification you will be asked for the key and value you wish to match. 
Order discount code
This will trigger a notification when the specified discount code is found to have been applied to an order.
Order fulfilment status
The order's status regarding fulfilled line items. Possible values include:

fulfilled: Every line item in the order has been fulfilled.
null: None of the line items in the order have been fulfilled.
partial: At least one line item in the order has been fulfilled.
restocked: Every line item in the order has been restocked and the order cancelled.
 
Order note
The contents of the notes field on the order.
Order shipping status
Allows merchants using carrier services that update shipping status in Shopify to trigger notifications based on these statuses. Available options are provided as a dropdown in the configuration interface.
Line Item Filters
Line item filters are the rules that determine which line items should appear in the notification. For example, if you're triggering by product SKU to send to supplier, it's likely that you'll also want to filter the line items that appear in the email by product SKU in order that the supplier only receives the salient items.
Order Field
Description
Product title
Include in the notification and line item with a matching product title.
Variant name
Include in the notification any line item with a matching variant name.
Product vendor
Include in the notification any line item with a matching product vendor.
Product SKU
Include in the notification any line item with a matching product SKU.
Product type
Include in the notification any line item with a matching product type.
Line item fulfillment status
Include in the notification any line item with a fulfillment status that matches the value of your filter.
Product tag
Include in the notification any line item with a matching product tag.
Product inventory quantity
Include in the notification any line item with a inventory quantity greater than or less than the value specified in your filter.
Line item property
Include in the notification any line item with a matching line item property.
Operators
Operators are the commands you select to determine your search criteria. For example: Product tag is equal toSale, in this case the is equal to is the operator, Product tag is the field and Sale is the value.
Operator
Field Type
Description
is equal to
Text, Numeric, Country Code, Fufillment Status, Tag, Bundles
The value field in your notification rule matches the value on the order exactly.
is not equal to
Text, Numeric, Country Code, Fufillment Status, Tag, Bundles
The value field in your notification rule does not match the value on the order exactly.
contains
Text, Numeric
The value on the order contains the value in your notification rule.
does not contain
Text, Numeric
The value on the order does not contain the value in your notification rule.
greater than
Numeric
The value on the order is greater than the value in your notification rule.
less than
Numeric
The value on the order is less than the value in your notification rule.
is blank
Text
The value on the order is blank i.e. the field is null.
is not blank
Text
The value on the order is not blank i.e. is set to something.
Getting Started - Previous
Customer & Order Tags
Next - Getting Started
Mastering Rules
Last modified 6mo ago
Copy link
Outline
Order Triggers
Line Item Filters
Operators