NEWDiscoverShipGoal– turn cart progress into bigger baskets
All articles

Choose the right Function input type for your rule

ShipWith Function input types control which Shopify checkout information a shipping rule can use in its conditions. Choose the input that provides the condition you need, not the one that sounds most general.

The condition picker in ShipWith shows the conditions available for the selected input. Use that list as the current source of truth. The examples below highlight common reasons to choose each input, but they are not a complete list.

Choose an input when you create the rule

You choose the Function input while creating a rule. After you save the rule, the Function input is locked and cannot be changed.

Changing the Function input before the first save clears the rule's conditions. If you have added or changed conditions, ShipWith asks you to confirm before clearing them. This prevents conditions from the old input from remaining on an input that might not support them. Review the available conditions and rebuild them after changing the input.

Standard input

Description in ShipWith: Common cart, customer, discount, and shipping address fields.

Choose Standard input for common rules based on cart amounts or quantities, products, customer details, discounts, or basic destination details. It is a good starting point when you do not need one of the specialized fields below.

Do not choose Standard when the rule must check an available shipping method title, cart-level attributes, cart weight, collections, or expanded destination fields such as city, company, phone, or address line 2. Check the condition picker for the exact fields available.

Shipping input

Description in ShipWith: Standard checkout fields plus shipping method title filters.

Choose Shipping input when a condition must check the title of an available shipping method. This lets a condition limit which delivery options the rule's actions can change. It can also suit product or collection checks and cart currency checks.

Do not choose Shipping for destination address conditions. It also does not support line item discount conditions or cart-level attributes. If the shipping method title is not part of the condition, another input may provide a better match.

Attribute input

Description in ShipWith: Cart and line item attributes, product content, selling plan, discount, and address checks.

Choose Attribute input when the rule must inspect a cart attribute or line item attribute. It is also the input for 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. Confirm the condition you need appears in the editor before building the rule.

Customer input

Description in ShipWith: Customer, B2B, order history, discount, and shipping address fields.

Choose Customer input for 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.

Do not choose Customer for product matching. 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.

Choose Address input when the rule depends on detailed destination data, including address lines, city, company, recipient name, phone, province, postal code, or PO box detection. Shopify can split a cart into multiple delivery groups, and ShipWith evaluates the address for each group separately.

Do not choose Address for product, collection, attribute, discount, or shipping method title conditions. Address input also includes selected cart and customer fields, but use the condition picker to confirm availability.

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, use the same Function input and confirm that it provides every condition both rules need.