¶ User Guide: Wishlist Add to cart customization
Change the Add to cart button on wishlist page product cards - or hide it and show a message - when a product matches a metafield rule. You can also attach a line item property when adding to cart.
Settings are store-wide (all themes). The feature is off by default.
Open: Wishlist Settings → More → Custom add to cart
Published guide: Wishlist Add to cart customization
Plan note: Available on Basic, Premium, and Ultimate. On Free, the section is visible but controls are disabled.
¶ 1. What this feature does
You can configure up to 5 rules. The first matching rule wins.
¶ Action: Customize Add to cart
When the product metafield condition matches:
- The wishlist page button can show your custom label (for example Pre-order).
- Adding to cart can attach a line item property (for example
STATUS=PRE-ORDER) in the current storefront language.
¶ Action: Hide Add to cart and show message
When the condition matches:
- The Add to cart button is hidden on the wishlist page card.
- A message is shown instead (for example Paris showroom exclusive).
¶ Where it applies
| Place | Included? |
|---|---|
| Wishlist page product cards | Yes |
| Wishlist drawer / popup | No |
| Shared wishlist page | No |
| “Add all to cart” | No |
¶ 2. Before you start
- Plan - Basic, Premium, or Ultimate.
- Wishlist page - Shoppers use a wishlist page (not only the drawer).
- Item action - Under Wishlist Settings → Page & drawer → Item actions, choose Add to Cart - Add item to cart. If it is set to More Details - Open the product page, customization / hide rules do not run.
- Product metafields - Ready in Shopify (for example a date metafield for Pre-order, or a choice metafield for Showroom Exclusive).
¶ 3. How to open the settings
- Go to Wishlist Settings → More → Custom add to cart.
- Turn on Enable wishlist Add to cart customization
- Add rules, then Save.
- Hard-refresh the storefront wishlist page and test with a matching product.
¶ 4. Settings explained
¶ 4.1 Enable
While off, wishlist cards keep the default Add to cart behavior.
¶ 4.2 Locale fallback
Used when the storefront locale does not match any configured locale row (for example en).
¶ 4.3 Rules (max 5)
Each rule has:
| Field | Meaning |
|---|---|
| Rule name | Label in admin only |
| Metafield namespace / Metafield key | e.g. custom / is_pre_order |
| Operator | Is present (non-empty) or Equals (exact value) |
| Match value | Only for Equals (e.g. Paris) |
| Action | Customize Add to cart (label + property) or Hide Add to cart and show message |
¶ Customize Add to cart
- Button labels by locale
- Optional Line item property key + values by locale
¶ Hide Add to cart and show message
- Default message by locale
- Optional messages by metafield value (map
Paris/New York/ … to translated texts)
¶ 5. Example: Pre-order + Made to Order + Showroom
Rule 1 - Pre-order
- Condition:
custom.is_pre_order→ Is present - Action: Customize Add to cart
- Labels: Pre-order / Pré-commander / …
- Property:
STATUS=PRE-ORDER/PRÉ-COMMANDE/ …
Rule 2 - Made to Order
- Condition:
custom.is_made_to_order→ Is present - Action: Customize Add to cart
- Labels: Made to Order / …
- Property:
TYPE=MADE TO ORDER/ …
Rule 3 - Showroom Exclusive
- Condition:
custom.exclusive_rooms→ Is present - Action: Hide Add to cart and show message
- Messages by value: Paris / New York / Tokyo → translated strings
A product should only match one of these metafields at a time. First match still wins if priorities overlap.
¶ 6. Troubleshooting
| Issue | Check |
|---|---|
| Nothing changes | Feature enabled + paid plan + Save + hard refresh |
| Still “Add to cart” | Metafield empty, wrong namespace/key, or Item actions is set to More Details |
| Showroom still buyable | Rule action must be Hide Add to cart and show message, not Customize |
| Wrong language | Locale codes (fr, en, de, ja) + Locale fallback |
| Only page works | Drawer, shared wishlist, and Add all are out of scope by design |