Age Verification
Age Verification displays a popup before visitors can access your store: requiring them to confirm they meet a minimum age requirement.
Protect Your Store with an Age Verification Popup
You can customize the minimum age, button text, colors, and redirect behavior to match your brand and legal requirements.
This feature works with the BSS B2B Lock app and is compatible with B2B-only and hybrid stores. Availability of advanced options (such as Require Date of Birth) may vary: some features are still coming soon.
On This Page
Section titled “On This Page”- Eligibility Requirements
- Understanding Age Verification
- Setting Up Age Verification
- Managing Existing Locks
- Real-World Examples
- Availability & Limitations
- Common Issues & Fixes
- Still Need Help?
Eligibility Requirements
Section titled “Eligibility Requirements”Before setting up Age Verification, confirm the following:
• The BSS B2B Lock app is installed on your Shopify store.
• Your store uses Shopify’s standard online storefront (not a headless or custom frontend).
• You have Admin access to your Shopify store.
• Your store sells age-restricted products or content that legally requires age gating.
• Compatible with B2B-only stores and hybrid B2B/B2C setups
Understanding Age Verification
Section titled “Understanding Age Verification”What It Is
Section titled “What It Is”Age Verification adds a gating popup to your store. Before any visitor can see your content, they must click a confirmation button. If they decline, they are redirected to a URL you specify. The popup appearance, text, and behavior are all fully configurable.
What You Can Do
Section titled “What You Can Do”• Gate your entire store, specific product pages, or specific collections: your choice.
• Set any minimum age: 18, 21, or any custom value.
• Customize all popup text: heading, description, confirm button, and exit button.
• Use the {{age}} placeholder in the description to automatically insert the age you set.
• Customize colors for the background, title, and both buttons.
• Set a redirect URL so declined visitors land on a specific page instead of the homepage.
Where It Applies
Section titled “Where It Applies”The popup appears on your live storefront, overlaying the page with a blurred background. It activates on every page included in the lock, and once a visitor confirms, the popup does not appear again while their cart exists. Use a new private window to test again.
Setting Up Age Verification
Section titled “Setting Up Age Verification”-
Create a Lock & Select Content to Restrict
Section titled “Create a Lock & Select Content to Restrict”-
Go to your Shopify Admin → Apps → BSS B2B Lock.
-
Click Locks in the left navigation.
-
Click Add lock rule. In the Start with a preset modal, select Create my own lock and click Continue.
-
In Step 1 – Lock Target, enter a Lock name (e.g. ‘Age Gate: Entire Store’) in the General Information card.
-
In the Lock Target card, open What do you want to lock? and choose what to restrict:

Figure 1: Step 1 – Lock Target: enter a Lock name, then choose what to lock. The Summary card on the right updates live.
Lock Target What It Does Entire store Shows the age popup on every page of your store. Products Restricts access to specific product pages only. Collections Restricts access to specific collection pages only. ⚠️ Note: The Variants and Price and add to cart targets do not offer age verification. For Variants, the app shows the warning “Locking variants does not support age verification, email subscriptions, or secret link access”. - Click Next to go to Step 2 – Access & Message.
-
-
Select ‘Age Verified’ as the Access Rule
Section titled “Select ‘Age Verified’ as the Access Rule”In Step 2 – Access & Message, you add the condition that triggers your age popup.
- In the Rule 1 card, under Select a condition to add to the rule, look at the condition chips (User type, Passcode, Date & time, More).
- Click More → Other condition.
- Open Select access rule and choose Age verified – Must confirm age.

Figure 2: Step 2 – Access & Message: More → Other condition → Age verified – Must confirm age.
⚠️ Note: Age Verification runs after Secret Link and Passcode but before Date & Time and Tag/Specific Customers rules. -
Click Done to confirm the condition.
-
In the Preview card on the right (under Summary), click Customize message to open the Preview & customize message modal for Age Verification.
-
Set the Minimum Required Age
Section titled “Set the Minimum Required Age”You are now in the Preview & customize message modal for Age Verification. Changes you make here update the Preview panel in real time.
- Expand the General Configuration section.
- Set the Minimum Required Age: enter a number (e.g. 18 or 21).
- Check the Preview on the right: the description text updates to show the correct age automatically.

Figure 3: General Configuration: set Minimum Required Age (shown as 21). The live Preview shows the popup with the age inserted in the description. ‘Require Date of Birth’ is labeled Coming Soon.
Coming Soon: The ‘Require Date of Birth’ toggle is visible but labeled Coming Soon. Do not attempt to enable it: it is not functional yet. -
Customize Appearance & Behavior
Section titled “Customize Appearance & Behavior”Expand the Appearance and Behavior sections to customize how your popup looks and what happens when a visitor clicks Exit.

Figure 4: Appearance section: customize the colors of the popup, its text and its buttons. Behavior section: choose the page the Exit button sends visitors to.
Setting Field Description & Tips Background Color The background color of the popup card (default: white #ffffff). Title Color Color of the popup heading text (default: black #000000). Button Main Color Background color of the ‘Enter Site’ (confirm) button. Button Second Color Background color of the ‘Exit’ button. Confirm Title Text color on the confirm button (default: white #ffffff). Exit Title Text color on the exit button (default: white #ffffff). Redirect URL (On Exit) URL visitors are sent to when they click Exit. Default: /index. Recommended: create a dedicated age restriction explanation page. ⚠️ Note: Upload image (background image for the popup) is labeled Coming Soon and cannot be used yet. -
Customize Modal Content (Popup Text)
Section titled “Customize Modal Content (Popup Text)”Expand the Model Content section to edit every piece of text shown inside the popup.

Figure 5: Model Content section: customize the text shown in the popup.
Setting Field Description & Tips Heading Text The main title of the popup (e.g. ‘Age Verification’). Description Text The explanation shown to visitors. Use {{age}}to auto-insert the minimum age you set: e.g. ‘You must be at least{{age}}years old to enter this site.’Confirm Button Text Label on the confirm/enter button (e.g. ‘Enter Site’, ‘I am 18 or older’). Exit Button Text Label on the exit/decline button (e.g. ‘Exit’, ‘I am under age’). Custom CSS Optional: paste custom CSS to override the default popup styles. For advanced users only. -
Save & Test
Section titled “Save & Test”- Close the modal and click Save in the Contextual Save Bar at the top of the page (or go to Step 3 – Exclude Pages and click Save there).
- Open your storefront in a private/incognito browser window.
- Navigate to a page covered by the lock.
- Verify the popup appears centered on screen with a blurred background.
- Confirm the heading, description, and button text match your configuration.
- Click Enter Site: confirm you gain access and the popup does not reappear on the next page you open.
- Click Exit (in a new private window): confirm you are redirected to the URL you configured.

Figure 6: Live storefront: Age Verification popup centered on screen with blurred background, showing ‘Enter Site’ and ‘Exit’ buttons.
Managing Existing Locks
Section titled “Managing Existing Locks”From the Locks list in the app:
• Edit a lock: Click the lock name or the edit icon to re-open the configuration.
• Enable or disable: Use the Status toggle on the Lock list, then click Save in the Contextual Save Bar. Inside the lock editor, set Status to Enable or Disable in the General Information card.
• Delete a lock: Click the delete/trash icon. This cannot be undone.
• Update age or text: Re-open the lock, click Customize message on the Preview card, make changes, and click Save.
- Age Verification Examples: ready-made setups for an 18+ store, 21+ products and a popup in another language.
- Age Verification Limitations and Troubleshooting: live and coming-soon options, common issues and fixes, and how to contact support.
- Age Verification ExamplesFollow three ready-made Age Verification setups: an 18+ alcohol store, 21+ restricted products, and a popup written in another language.
- Age Verification Limitations and TroubleshootingCheck which Age Verification options are live or coming soon, and fix a popup that does not appear, shows the wrong age or redirects wrongly.
- Checkout LockCheckout Lock gives you full control over who can complete a purchase on your store, and how they pay.
- Countdown LockClock Countdown replaces a static lock message with a live ticking timer, showing customers exactly how long until content becomes available, down to the second.