Choose the right Function input type for your rule
ShipWith Function input types control which Shopify checkout information a shipping rule can read. Each input reads different checkout data, and no single input supports every condition.
You do not choose a Function input when you create a rule. ShipWith picks it for you based on the rule's conditions. This article explains how that works and which conditions each input supports, so you know which conditions can be combined in one rule.
How ShipWith picks the Function input
New rules start with no conditions and Standard input.
When you select Add condition or Add group (OR), or the pencil on a condition, ShipWith opens a condition picker with a search field. It lists every condition from every Function input.
After you add or change a condition, ShipWith checks the rule's Function input:
- If the current input still supports all of the rule's conditions, ShipWith keeps it.
- If it does not, ShipWith switches to the first input that supports all of them, in this order: Standard, Shipping, Attribute, Customer, Address, Catalog.
Some conditions cannot run together in one rule because no single input supports all of them. In the picker, these conditions appear greyed out under Can't be combined with your existing conditions, and you cannot select them. When you change an existing condition with the pencil, ShipWith ignores that condition in this check.
The operators offered for a condition can also depend on your other conditions. For example, the collection operators for Cart contains exist only on Shipping input and Attribute input, so they appear only when those inputs fit the rest of the rule.
Rules set to Always have no conditions, so every input fits. Their Function input stays as saved.
See or change the Function input
The rule's sidebar has an Advanced card. Select Show advanced settings to see the rule's Function input. Select the pencil next to it to open Change function input.
Each function input reads different checkout data, so you can only pick one that supports all your conditions. Inputs that do not fit appear greyed out under Doesn't support your conditions.
The Function input is not locked. It can change on saved rules too, either when you change the conditions or from the Advanced card.
Which conditions each input supports
The sections below describe each input and common conditions it supports. They are not a complete list. The condition picker and the Advanced card show current availability.
Standard input
Description in ShipWith: Common cart, customer, discount, and shipping address fields.
Standard input fits common rules based on cart amounts or quantities, products, customer details, discounts, or basic destination details. It also offers address line 2 and PO Box, so a PO box condition can be combined with conditions on what is in the cart. New rules start on this input.
Standard does not support available shipping method titles, cart-level attributes, cart weight, collections, customer total spent, or expanded destination fields such as city, company, or phone. Adding one of these conditions moves the rule to another input.
Shipping input
Description in ShipWith: Standard checkout fields plus shipping method title filters.
Shipping input is the input for conditions that check the title of an available shipping method. This lets a condition limit which delivery options the rule's actions can change. It also supports product or collection checks and cart currency checks.
Shipping does not support destination address conditions, line item discount conditions, or cart-level attributes, so these cannot be combined with a shipping method title condition.
Attribute input
Description in ShipWith: Cart and line item attributes, product content, selling plan, discount, and address checks.
Attribute input is the input for cart attribute and line item attribute conditions. It also supports cart weight and detailed product checks such as collections or variant titles.
The current Function input reads one configured cart attribute key and one configured line item attribute key for each Attribute input sync. Active rules using this input cannot require multiple keys of either kind. It does not read SKU or selling plan data, and its destination support is limited to postal code. A rule on this input cannot use those conditions.
Customer input
Description in ShipWith: Customer, B2B, order history, discount, and shipping address fields.
Customer input fits customer history and identity rules, including order count, total spend, B2B details, customer country, or expanded shipping address details such as city, company, and recipient name.
Customer does not support product matching, because the Customer Function does not read product data. It also does not provide cart attributes, cart weight, shipping method title conditions, or address line 2.
Address input
Description in ShipWith: Destination address fields for each delivery group.
Address input fits rules that depend on detailed destination data, including address lines, city, company, recipient name, phone, province, postal code, or PO box detection. If a PO box rule also needs product conditions, ShipWith uses Standard input instead. Shopify can split a cart into multiple delivery groups, and ShipWith evaluates the address for each group separately.
Address does not support product, collection, attribute, discount, or shipping method title conditions. Address input also includes selected cart and customer fields. The condition picker shows which ones can be combined.
Catalog input
Description in ShipWith: Product and variant metafields you choose, plus cart totals and shipping destination.
Catalog input is the input for metafield conditions, when you group products or variants with a metafield, like custom.shipping_group. This scales to large catalogs, because the rule stores the metafield values, not a list of picked variants. It also offers cart subtotal, cart total, cart quantity, quantity per line, customer tag, shipping country, province code, and ZIP code.
All Live and Test Catalog input rules share one variant metafield and one product metafield. The metafield must be single line text. Adding a metafield condition moves the rule to Catalog input automatically. See "Target shipping methods with product or variant metafields" for setup steps.
Catalog does not support product, collection, tag, or product type picks, cart attributes, or detailed address fields, so these cannot be combined with metafield conditions.
When rules use different inputs
ShipWith groups active rules by Function input. Within one input type, lower Priority numbers run first. Shopify does not guarantee the execution order of different Function inputs, so do not rely on priority to coordinate rules that use different inputs.
If two rules must run in a specific order, open each rule's Advanced card and make sure both use the same Function input. If they differ, change the input there when one shared input supports all of their conditions.
