A payment, shipping, or checkout rule isn't working

Nothing changes at checkout

1. Enabled? On Customizations, the function’s status should be Enabled. In Shopify admin, it should also appear under Payment customizations, Delivery customizations, or Checkout rules. Disabled means it’s turned off, here or in Shopify admin: open it and turn it on under Status. Deleted in Shopify means it was removed in Shopify admin: delete it here too and create a new one.
2. Conditions passing? Switch to Apply to all checkouts to test. If it then works, one of the conditions is the problem. Switching clears the conditions, so click Export on the Conditions card first and import them back afterwards. Volume, spend tiers, group price, combo, Buy X get Y, flex and code rules discounts don’t have Export: note their conditions down first.
3. Name matching? Payment and shipping functions match names that contain your text. For shipping, copy the name exactly as it shows at checkout. For payment, use the name Shopify gives the function: cards go by the card provider’s name, such as Shopify Payments, not “Credit card” (payment method names). With Require exact name match on a shipping function, capitals and spaces must match too.
4. Conditions from the right condition set? Only use conditions offered for the function’s condition set. If a function stopped working after you added a condition, remove that condition and save.
5. Too many functions? Shopify limits how many payment customizations, delivery customizations, and checkout rules a store can have. Delete ones you no longer use.
6. “Not supported by this customization” under a condition? The function can’t read that condition or comparison, so it does nothing. Remove or change it, then save.
7. “Over Shopify’s function limit” at the top of the edit page? The settings are over Shopify’s limit of 10,000 bytes, so it does nothing. Remove some products, collections or conditions, then save.

Only some payment methods are hidden

Hide and rename change only the first payment method that matches each setting. Tick Hide every matching payment method to hide them all.

Credit cards in the US and Canada stay as they are unless the store is on Shopify Plus: Shopify doesn’t let payment functions change them on other plans.

The wrong payment method is hidden

A setting changes the first payment method whose name contains your text, so Pay hides “PayPal” when it comes before “Shop Pay”. Make the name more specific, or tick Require exact name match.

Every shipping option disappeared

A Hide shipping method setting with a blank Shipping method name, or with Show only specified shipping method and a name that doesn’t match, hides everything. Fill in the name, or untick Show only specified shipping method.

A cart attribute condition doesn’t work

• A function reads only one cart attribute key. Two conditions with different keys don’t work together, and the editor warns under the one that won’t work. The checkout blocker’s Condition set 4 reads up to five.
• Keys and values usually have to match exactly, including capitals.
• includes isn’t offered for cart attributes on shipping rules, checkout blockers and express checkout button rules, where it never matches. An older rule that uses it shows “Not supported by this customization. Choose another comparison.”: change it to is equal to or is not equal to.
• The attribute must exist before the function runs. If a block sets it, see use block conditions in functions.

The checkout blocker blocks everyone

The conditions describe when to block. With Apply to all checkouts, every checkout is blocked. Set the conditions to match the situation you want to stop, such as Number of items is more than 10.

The checkout blocker’s message doesn’t show

• Wait until the buyer pays is ticked: the message shows only when the customer clicks Pay now, not while they fill in checkout.
• The blocker has no Error message. A blocker saved without one, before the message was required, never blocks: open it and add one.
• It runs in checkout, not on the cart page. For limits that also check the cart, use purchase limits.

A purchase limit isn’t stopping customers

• Minimums and pack sizes are checked at checkout only, so customers can fill their cart first. Maximums are also checked when the cart changes, unless Block Add to cart over a maximum is unticked.
• Who it applies to, Only in some countries or regions and Only between dates leave out everyone else. A limit for customers with tags skips guests, who have no tags.
• A limit per customer needs the two Shopify Flow workflows turned on, and counts only orders placed after that. See per-customer limits.
• The product isn’t in the limit, or it’s under Leave out some items.
• Nothing shows on the product page. That’s the Purchase limits app embed, turned on apart from the limit: see product and cart pages.

The address blocker doesn’t catch an address

• Only the Applicable fields you ticked are checked, and only on the shipping address. Orders with nothing to ship aren’t checked.
• Character minimum and Must include a number pass an empty field. Add a Required setting for the same field.
• A Markets card set to Apply to selected markets only leaves out the other markets.

Express checkout buttons still show

Hide accelerated checkout payment methods is for Shopify Plus stores, and hides the wallets you leave unticked: the ones you tick stay. To hide a wallet from the payment list too, add a Hide payment method rule for it.

It stopped working after a plan change

Moving to the Free plan deletes the customizations Free doesn’t include, such as a checkout blocker, an address blocker, purchase limits and B2B order review, and turns Build a box off. Payment and shipping rules stay. See downgrade to Free.

Changes didn’t take effect

Changes to tags, attribute keys, and metafield names in conditions take effect when you save the function. After editing conditions, click Save, then start a fresh checkout to test.