> For the complete documentation index, see [llms.txt](https://orbit-b2b.gitbook.io/orbit-b2b-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://orbit-b2b.gitbook.io/orbit-b2b-docs/catalog-visibility/precedence.md).

# 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 |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://orbit-b2b.gitbook.io/orbit-b2b-docs/catalog-visibility/precedence.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.