> 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/masked-price-and-unlock.md).

# Masked price & Unlock button

This is what a gated shopper actually experiences on the storefront.

## The masked price

Instead of the real price, a gated shopper sees the **currency symbol next to a blurred `XXX`**:

```
$ XXX        (the XXX is blurred)
```

* The **real number is never written to the page** — only the literal `XXX` is rendered. That means a shopper **cannot reveal the price by editing CSS** or removing the blur.
* Price **ranges** are fully masked too: `$10 – $20` becomes `$ XXX – $ XXX`.
* The currency symbol / code stays sharp so the page still reads naturally.

## The Unlock button

A bordered **Unlock wholesale price** button appears right under the price — on product pages **and** on collection cards (cards have no Add-to-cart button to attach to). It links to sign-in.

In **Hide price and block Add-to-cart** mode, the Add-to-cart button is hidden and the Unlock button takes its place. Any "Min N pcs" MOQ badge is also removed (a quantity floor next to a locked price would be confusing).

## How sign-in works

Shopify's current customer accounts use **passwordless sign-in** — the shopper enters their email and Shopify sends a one-time code. The sign-in pages are hosted by Shopify, so:

* The Unlock button sends the shopper to Shopify's sign-in and **returns them to the same page** afterwards.
* On themes that include Shopify's account component, the sign-in opens as a panel **without leaving the store**.

> A fully custom in-theme login form is no longer possible with the new customer accounts — login is hosted by Shopify. The Unlock button uses Shopify's official sign-in route so it works on every theme.

## Editing the button text (and translating it)

The Unlock button label is **not** on the Catalog Visibility page. It lives in **Settings → Storefront Text → Catalog Visibility**, so all your storefront copy is managed and translated in one place.

* Leave it blank to use the built-in default, **"Unlock wholesale price"**, which ships translated in English, Vietnamese, French, German, Spanish, and Japanese.
* Use the locale tabs in Storefront Text to set a different label per language.


---

# 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/masked-price-and-unlock.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.
