Skip to main content
The Age verification popup displays a modal overlay requiring visitors to confirm their age before accessing your site. Commonly used for stores selling age-restricted products like alcohol, tobacco, CBD, or adult content, this popup ensures compliance with age restrictions while maintaining a professional user experience. Visitors verify their age once per browser session, preventing repeated interruptions.

​
What this section controls

This section controls age verification displays with the following capabilities:
  • Modal popup overlay requiring age confirmation
  • Session-based verification (verify once per browser session)
  • Customizable heading and descriptive text
  • Confirm button with three style options (Filled, Outlined, Text)
  • Decline button with configurable redirect URL
  • Optional blurred backdrop for visual focus
  • Heading size controls (XS to XL)
  • Rich text support for content customization

​
Section settings

Heading — Main verification prompt displayed to visitors (default: “Verify your age”). Supports rich text formatting.Heading size — Control the heading size from XS to XL (default: XL)Text — Descriptive content explaining your age requirements. Default: “You must be 18 years of age or older to enter this site. Please verify your age.”Supports rich text formatting for multiple paragraphs or emphasized text.
Enable Show blurred backdrop to blur the page content behind the popup, creating visual focus on the verification prompt.Default: Disabled
You may need to refresh the Theme Customizer preview to see backdrop blur changes take effect.
Configure the button users click to confirm they meet age requirements:Button confirm — Button label text (default: “Yes”)Button confirm style — Visual appearance:
  • Filled (default) — Solid background button
  • Outlined — Border-only button
  • Text — Text-style link button
When clicked, the popup closes and stores the verification in the browser session.
Configure the button for visitors who don’t meet age requirements:Button decline — Button label text (default: “No”)Button decline URL — Destination when declined (default: /). Typically set to your homepage, a “must be 18+” page, or an external site like Google.Button decline style — Visual appearance:
  • Filled
  • Outlined (default)
  • Text
Use contrasting styles between confirm and decline buttons to guide user choice. The defaults (filled for confirm, outlined for decline) create clear visual hierarchy.
Enable Show popup on customizer to display the age verification popup while editing in the Theme Customizer. This allows you to preview and adjust the popup design without refreshing the page.Default: DisabledWhen disabled, the popup won’t appear in the customizer but will still show to actual site visitors.
Select the color scheme for the popup overlay, including background, text, and button colors (default: scheme-1).

​
Best practices

Clear messaging

State age requirements clearly and concisely. Use language appropriate for your jurisdiction (e.g., “21+” for US alcohol, “18+” for most other products).

Button hierarchy

Use filled buttons for the confirm action and outlined or text buttons for decline to create clear visual hierarchy.

Backdrop blur

Enable backdrop blur to improve focus on the verification prompt and prevent users from interacting with page content before verifying.

Decline destination

Set the decline URL to an appropriate page—either your homepage, an informational page, or an external site.

Legal compliance

Ensure your age verification meets legal requirements for your jurisdiction and product type. Consult legal counsel if needed.

Mobile testing

Test the popup display and button interactions on mobile devices to ensure usability on smaller screens.
Important: An age verification popup provides a basic age gate but may not satisfy all legal requirements in your jurisdiction. This is a self-attestation system—visitors simply click to confirm their age without providing proof.For regulated products like alcohol, tobacco, or cannabis, consult with legal counsel to determine if additional age verification measures are required, such as:
  • ID verification at checkout
  • Third-party age verification services
  • Age verification at delivery
  • Geolocation restrictions

​
Common use cases

  • Alcohol sales — Verify 21+ age (US) or 18+ (many other regions)
  • Tobacco and vaping — Age gate for tobacco, e-cigarette, or nicotine product sales
  • CBD and cannabis — Age verification for CBD, hemp, or cannabis products where legal
  • Adult content — 18+ verification for mature content or products
  • Gaming and gambling — Age verification for betting, lottery, or gambling sites
  • Mature video games — Age gate for M-rated or AO-rated game sales
  • Dietary supplements — Some supplement categories require age verification

​
Technical notes

The age verification popup uses browser session storage to remember verification status. This means:
  • Visitors verify once per browser session
  • Closing the browser clears the verification
  • Opening a new private/incognito window requires re-verification
  • Verification is not shared across devices or browsers
The popup appears automatically on page load to unverified visitors. Once confirmed, the session storage flag prevents the popup from showing again until the session ends.

Custom liquid

Add custom age verification logic with additional requirements