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

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.

Last updated

Was this helpful?