For the complete documentation index, see llms.txt. This page is also available as Markdown.

Priority over pricing

Catalog Visibility is an access layer that sits on top of your pricing. It is always evaluated first, per product.

It wins over Wholesale Discount & Volume Pricing

If a shopper is not in the audience, the gate hides the price even when:

  • a Wholesale Discount targets "All Customers", or

  • a Volume Pricing rule applies to the product.

A gated shopper sees none of these:

  • the "Save X%" badge

  • the B2B / discounted price

  • the Volume Pricing table

…only the masked price and the Unlock button. The moment the shopper qualifies (logs in / is in the right group), normal B2B pricing returns automatically.

In short: eligible shoppers see your best price; everyone else sees nothing until they sign in.

Surfaces it covers

  • Product pages (PDP)

  • Collection / listing cards

  • Search results

  • The Volume Pricing table

  • The cart drawer / cart page

It does not change the checkout page UI (Shopify locks that) — the validation function below is the backstop there.

Hard checkout block (Hide price and block Add-to-cart mode)

Hiding the Add-to-cart button is a front-end (UX) layer — a technical user could still force an item into the cart via the storefront API. To back it up, a Cart & Checkout Validation Function runs server-side:

  • If an ineligible shopper has a gated product in the cart, checkout is blocked with a message.

  • This is the strongest server-side gate Shopify allows on the online store.

This applies only in Hide price and block Add-to-cart mode; in Hide price only mode purchases are allowed.

Quick reference

Shopper
Price
Add-to-cart (mode 2)
Checkout (mode 2)

In audience (eligible)

Real B2B price

Allowed

Allowed

Out of audience (gated)

Masked $ XXX + Unlock

Blocked

Blocked by validation function

Last updated

Was this helpful?