← All notes

HBN Notes / Shopify guide

What should checkout say when only one item can’t ship to an address?

Write a Shopify checkout message that identifies the item with a delivery restriction, explains the address correction, and still makes sense without the item name.

Published

Imagine a shopper puts a floor lamp and a set of spare bulbs in their Shopify cart. The bulbs can ship to a PO box, but the lamp requires a street address. If checkout just says “Invalid address,” the shopper has to guess whether they mistyped it or one of the items has a delivery restriction.

Tell the shopper which item needs a different address

Start with the address change the shopper can make. Name the affected item when you can, including the variant if the restriction applies to only one size or configuration. These examples show how the same rule can read with and without the item name.

With the item name. “Enter a street address to ship the Floor Lamp. It can’t ship to a PO box.”

Without the item name. “Enter a street address to continue. At least one item in your cart can’t ship to a PO box.”

Include removal as an option only after testing the bulbs on their own at that same PO box. If they can ship there, the shopper can go back to the cart, remove the lamp, and retry. If another rule still blocks the address, the message should give the shopper a correction they can actually use.

Write the message so it works without an item name

In HBN Address Rules, we let merchants write the checkout message and show affected item names when space permits. On Pro, a policy can target selected products, variants, or collections. Write the base message so it gives the correction on its own, then check how the message reads with the item names added. Shopify’s checkout validation documentation explains how a validation error can stop checkout and show a message.

Check both ways out of the error

  1. Use test products and an example PO box. Try the lamp and bulbs together and read the message at the point Shopify blocks the order.
  2. Keep both items and try an accepted street address. Confirm that the original restriction clears.
  3. Return to the PO box and remove the lamp. Check whether the bulbs can still be ordered before you tell a shopper to use that option.
  4. Repeat with a long item name or several restricted items. Check that the correction is clear even if the names are omitted.

For product selection, exceptions, and split delivery, use the product-specific address rule checklist. To decide whether the rule should apply to every item, see the Shopify PO box guide.