> 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/overview.md).

# Overview

**Catalog Visibility** hides your prices from shoppers who aren't your B2B customers. When it's on, anyone outside the audience you choose sees a **masked price** — the currency symbol stays, the number is blurred — plus an **"Unlock wholesale price"** button instead of the real price. Optionally you can also block Add-to-cart for those shoppers.

It's one global setting for the whole store (not a list of rules), found under **Pricing → Catalog Visibility**.

## Why use it

* Stop "random" visitors and competitors from seeing your wholesale rates
* Push guests to log in / register as a B2B customer before they can see prices
* Optionally block purchases entirely until a buyer is an approved B2B customer

## What a gated shopper sees

```
$ XXX   [🔒 blurred]
[ Unlock wholesale price → ]
```

* The **currency symbol stays sharp**; the number is replaced by a blurred `XXX`.
* The real price is **never sent to the page**, so it can't be revealed by editing CSS.
* An **Unlock wholesale price** button sits under the price and links to sign-in.

As soon as the shopper qualifies (logs in / is in the right group), the real B2B price appears again.

## Key behaviors

* **Takes priority over pricing.** A gated shopper never sees a Wholesale Discount badge, B2B price, or Volume Pricing table — even when a rule targets "All Customers". See [Priority over pricing](/orbit-b2b-docs/catalog-visibility/precedence.md).
* **Two modes.** Hide price only, or hide price **and** block Add-to-cart. See [Modes & audience](/orbit-b2b-docs/catalog-visibility/modes-and-audience.md).
* **Flexible scope.** Apply to all products or narrow it down, with an exclude list. See [Product scope](/orbit-b2b-docs/catalog-visibility/product-scope.md).
* **One place for the copy.** The Unlock button label is edited (and translated) in **Settings → Storefront Text → Catalog Visibility**.

## Requirements

* Plan: **Advanced+**
* The Wholesale app embed must be enabled in your theme (Theme editor → App embeds).

## Next steps

1. [Modes & audience](/orbit-b2b-docs/catalog-visibility/modes-and-audience.md) — pick how strict it is and who may see prices
2. [Product scope](/orbit-b2b-docs/catalog-visibility/product-scope.md) — choose which products it covers
3. [Masked price & Unlock button](/orbit-b2b-docs/catalog-visibility/masked-price-and-unlock.md) — what shoppers see and how sign-in works
4. [Priority over pricing](/orbit-b2b-docs/catalog-visibility/precedence.md) — how it interacts with discounts


---

# 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/overview.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.