> For the complete documentation index, see [llms.txt](https://docs-shpf.bsscommerce.com/bss-b2b-lock-login-password-hide-price/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-shpf.bsscommerce.com/bss-b2b-lock-login-password-hide-price/other-locks/age-verification.md).

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

{% hint style="success" %}
**⭐ Best Practice**

Use the {age} placeholder in your Description Text — it automatically fills in the minimum age you set.

Set a dedicated Redirect URL (On Exit) instead of /index — point to an explanation page for a better user experience.

Always test the popup in an incognito window after saving to confirm it appears correctly on your storefront.
{% endhint %}

### **On This Page**

1. [Eligibility Requirements](#eligibility-requirements)
2. [Understanding Age Verification](#understanding-age-verification)
3. [Availability & Limitations](#availability-and-limitations)
4. [Setting Up Age Verification](#setting-up-age-verification)
5. [Real-World Examples](#real-world-examples)
6. [Managing Existing Locks](#managing-existing-locks)
7. [Common Issues & Fixes](#common-issues-and-fixes)
8. [Still Need Help?](#still-need-help)

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

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

• 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**

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 during that session.

## **Availability & Limitations**

| **Feature**              | **Status**     | **Notes**                                              |
| ------------------------ | -------------- | ------------------------------------------------------ |
| Age Verification popup   | ✅ Live         | Works on entire store, products, or collections        |
| Minimum Required Age     | ✅ Live         | Set any numeric age — e.g. 18, 21                      |
| Appearance customization | ✅ Live         | Colors, background, button styles                      |
| Modal Content (text)     | ✅ Live         | Heading, description with {age}, button labels         |
| Redirect URL on Exit     | ✅ Live         | Redirect declined visitors to any URL                  |
| Upload background image  | �� Coming Soon | Image upload for popup background not yet available    |
| Require Date of Birth    | �� Coming Soon | DOB input field — not available yet                    |
| Custom CSS               | ✅ Available    | For advanced users who want to override default styles |

| **�� Coming Soon:** Require Date of Birth is not yet available. The toggle appears in the app but cannot be activated. Wait for the Coming Soon release. |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- |

## **Setting Up Age Verification**

#### **1. Create a Lock & Select Content to Restrict**

1\. Go to your **Shopify Admin** → **Apps** → **BSS B2B Lock**.

2\. Click **Locks** in the left navigation.

3\. Click **Add lock rule**. In the **Start with a preset** modal, select **Create my own lock** and click **Continue**.

4\. In **Step 1 – Lock Target**, enter a **Lock name** (e.g. 'Age Gate — Entire Store') in the **General Information** card.

5\. In the **Lock Target** card, open **What do you want to lock?** and choose what to restrict:

<figure><img src="https://684288492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJh4ZJQcYHPWkPeDOGrHj%2Fuploads%2Fgit-blob-b3425c06ad981635bca6e235410401c190e4d0ac%2Fstep1-overview-lock-name.png?alt=media" alt="Figure 1 — Step 1 – Lock Target: the stepper, the General Information card (Lock name and Status), the What do you want to lock? dropdown and the Summary card on the right."><figcaption><p>Figure 1 — Step 1 – Lock Target: enter a Lock name, then choose what to lock. The Summary card on the right updates live.</p></figcaption></figure>

| **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". |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

6\. Click **Next** to go to **Step 2 – Access & Message**.

#### 2. **Select 'Age Verified' as the Access Rule**

In **Step 2 – Access & Message**, you add the condition that triggers your age popup.

1. 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**).
2. Click **More** → **Other condition**.
3. Open **Select access rule** and choose **Age verified – Must confirm age**.

<figure><img src="https://684288492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJh4ZJQcYHPWkPeDOGrHj%2Fuploads%2Fgit-blob-d86e416fd93bee031e5ea1eb83576f86ab3e4ce6%2Fstep2-other-condition-age-verified.png?alt=media" alt="Figure 2 — Step 2 – Access &#x26; Message: Condition 1: Other condition with the Select access rule dropdown open, showing URL parameter, Secret link, Age verified – Must confirm age, and Custom code (Liquid)."><figcaption><p>Figure 2 — Step 2 – Access &#x26; Message: More → Other condition → <strong>Age verified – Must confirm age</strong>.</p></figcaption></figure>

| **⚠️ Note:** Age Verification runs after Secret Link and Passcode but before Date & Time and Tag/Specific Customers rules. |
| -------------------------------------------------------------------------------------------------------------------------- |

4\. Click **Done** to confirm the condition.

4\. In the **Preview** card on the right (under **Summary**), click **Customize message** to open the **Preview & customize message** modal for Age Verification.

#### **3. 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.

1. Expand the General Configuration section.
2. Set the Minimum Required Age — enter a number (e.g. 18 or 21).
3. Check the Preview on the right — the description text updates to show the correct age automatically.

<figure><img src="https://684288492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJh4ZJQcYHPWkPeDOGrHj%2Fuploads%2FqxFhJmQ2gkIfwwhMsf3b%2Fimage.png?alt=media&amp;token=4664978b-5f21-47a1-bd99-3abb36507a7b" alt="Figure 3 — General Configuration: set Minimum Required Age (shown as 21). The live Preview shows the popup with the age inserted in the description. &#x27;Require Date of Birth&#x27; is labeled Coming Soon."><figcaption><p>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.</p></figcaption></figure>

| **�� 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. |
| -------------------------------------------------------------------------------------------------------------------------------------------------- |

4. Customize Appearance & Behavior

Expand the Appearance and Behavior sections to customize how your popup looks and what happens when a visitor clicks Exit.

<figure><img src="https://684288492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJh4ZJQcYHPWkPeDOGrHj%2Fuploads%2Fc1fH8AtiAYs6dk79okEr%2Fimage.png?alt=media&amp;token=7ba79a73-ccf9-42b6-aadc-dbb9bdfa5f47" alt="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."><figcaption><p>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.</p></figcaption></figure>

| **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. |
| --------------------------------------------------------------------------------------------------------- |

5. Customize Modal Content (Popup Text)

Expand the Model Content section to edit every piece of text shown inside the popup.

<figure><img src="https://684288492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJh4ZJQcYHPWkPeDOGrHj%2Fuploads%2Focks4Sue3lQqLxZ9uYIx%2Fimage.png?alt=media&amp;token=fda983eb-ae8e-404d-88e5-cc8e001e56c9" alt="Figure 5 — Model Content section: customize the text shown in the popup."><figcaption><p>Figure 5 — Model Content section: customize the text shown in the popup.</p></figcaption></figure>

| **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.                                                            |

{% hint style="success" %}
**�� Tip — Use {age} in Description Text**

The {age} placeholder is automatically replaced with whatever number you enter in Minimum Required Age.

This means you only need to update the age in one place — the description text stays accurate automatically.
{% endhint %}

#### **6. Save & Test**

1. 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).
2. Open your storefront in a private/incognito browser window.
3. Navigate to a page covered by the lock.
4. Verify the popup appears centered on screen with a blurred background.
5. Confirm the heading, description, and button text match your configuration.
6. Click Enter Site — confirm you gain access and the popup does not reappear in the same session.
7. Click Exit (on a fresh session) — confirm you are redirected to the URL you configured.

<figure><img src="https://684288492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJh4ZJQcYHPWkPeDOGrHj%2Fuploads%2FLbydMLgHFpgRISyPWMBE%2Fimage.png?alt=media&amp;token=3e277b95-310c-4483-b5ef-7b86a57b245c" alt="Figure 6 — Live storefront: Age Verification popup centered on screen with blurred background, showing &#x27;Enter Site&#x27; and &#x27;Exit&#x27; buttons."><figcaption><p>Figure 6 — Live storefront: Age Verification popup centered on screen with blurred background, showing 'Enter Site' and 'Exit' buttons.</p></figcaption></figure>

{% hint style="success" %}
**✅ Verification Checklist**

Popup appears on all pages covered by the lock — ✓

Heading, description, and button text match configuration — ✓

Age number in description matches the Minimum Required Age you set — ✓

Enter Site grants access and popup does not reappear in the same session — ✓

Exit redirects to the correct URL — ✓
{% endhint %}

## **Real-World Examples**

{% hint style="info" %}
**Example 1 — Alcohol Store, 18+ Requirement (Entire Store)**

1. Go to Locks → Add lock rule → Create my own lock → Continue → select Entire store.
2. In Step 2, add \*\*More → Other condition → Age verified – Must confirm age\*\* to Rule 1.
3. On the Preview card, click Customize message.
4. Set Minimum Required Age = 18.
5. Description Text: 'You must be at least {age} years old to enter this site.'
6. Confirm Button: 'I am 18 or older' / Exit Button: 'Exit'.
7. Click Save.

**Result:** All visitors see the age popup before accessing the store. Those who decline are redirected to /index.
{% endhint %}

{% hint style="info" %}
**Example 2 — Weapons Store, 21+ Requirement (Products Only)**

1. Go to Locks → Add lock rule → Create my own lock → Continue → select Products → choose the relevant products.
2. In Step 2, add \*\*More → Other condition → Age verified – Must confirm age\*\* to Rule 1.
3. On the Preview card, click Customize message.
4. Set Minimum Required Age = 21.
5. Heading Text: 'Age Restriction' / Description: 'You must be {age}+ to view these products.'
6. Redirect URL (On Exit): '/pages/age-restriction'.
7. Click Save.

**Result:** Restricted products remain locked until the visitor confirms they are 21+. Those who decline are redirected to a dedicated notice page.
{% endhint %}

{% hint style="info" %}
**Example 3 — Custom Language Popup**

1. Set Minimum Required Age = 18.
2. Heading Text: „Altersverifizierung“
3. Description: „Sie müssen mindestens {age} Jahre alt sein, um auf diese Seite zuzugreifen.“
4. Confirm Button: „Seite betreten“ / Exit Button: „Verlassen“
5. Click Save.

**Result**: The popup appears in German (or any language you write), suitable for your target market.
{% endhint %}

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

## **Common Issues & Fixes**

| **What You See**                                | **Why It Happens**                                                  | **What to Do**                                                                                         |
| ----------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| Popup is not appearing on the storefront.       | The lock is disabled, or the wrong content was selected.            | Open the lock, confirm On/Off is On, and verify the correct pages are covered.                         |
| The age number is wrong in the description.     | {age} placeholder is working correctly — the wrong age was entered. | Re-open the lock → **Customize message** → General Configuration, and update the Minimum Required Age. |
| Exit button is not redirecting correctly.       | The Redirect URL (On Exit) field is empty or has an incorrect URL.  | Open the lock → **Preview** card → **Customize message** → Behavior section → update the Redirect URL. |
| Popup reappears even after confirming.          | Session was cleared or visitor used a different browser/device.     | This is expected behavior — confirmation is session-based.                                             |
| 'Require Date of Birth' toggle does nothing.    | This feature is not yet available.                                  | Wait for the Coming Soon release. The toggle will become functional when ready.                        |
| Colors or text are not updating in the Preview. | Changes may not have been saved.                                    | Click Save and refresh. Check that the Preview is visible before saving.                               |
| Popup appears on pages I did not intend.        | Lock Target was set to 'Entire store' instead of specific pages.    | Edit the lock, change the Lock Target to the correct content type.                                     |

## **Still Need Help?**

Click Chat support in the app or email **<support-sbc@bsscommerce.com>**. Our team can configure the lock for you.

• Click Chat support in the Need help? panel visible in the lock editor.

• Or email **<support-sbc@bsscommerce.com>** with the details below.

When contacting support, include:

• Your shop URL (e.g. yourstore.myshopify.com)

• The name of the lock with the issue

• What you expected vs. what actually happened

• A screenshot or screen recording if possible

{% hint style="info" %}
**�� Try This First**

Check that the lock On/Off toggle is set to On.

Test in a private/incognito window — previous sessions may have already confirmed the age.

Review the **Summary** card to confirm **Access & Message** lists the Age verified condition under Rule 1.
{% endhint %}

<br>