> ## Documentation Index
> Fetch the complete documentation index at: https://docs.digifist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Age verification popup

> Modal popup requiring age confirmation before site access

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

<AccordionGroup>
  <Accordion title="Content">
    **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.
  </Accordion>

  <Accordion title="Blurred backdrop">
    Enable **Show blurred backdrop** to blur the page content behind the popup, creating visual focus on the verification prompt.

    Default: Disabled

    <Note>
      You may need to refresh the Theme Customizer preview to see backdrop blur changes take effect.
    </Note>
  </Accordion>

  <Accordion title="Confirm button">
    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.
  </Accordion>

  <Accordion title="Decline button">
    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

    <Tip>
      Use contrasting styles between confirm and decline buttons to guide user choice. The defaults (filled for confirm, outlined for decline) create clear visual hierarchy.
    </Tip>
  </Accordion>

  <Accordion title="Customizer visibility">
    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: Disabled

    When disabled, the popup won't appear in the customizer but will still show to actual site visitors.
  </Accordion>

  <Accordion title="Color scheme">
    Select the color scheme for the popup overlay, including background, text, and button colors (default: scheme-1).
  </Accordion>
</AccordionGroup>

## Best practices

<CardGroup cols={2}>
  <Card title="Clear messaging" icon="message">
    State age requirements clearly and concisely. Use language appropriate for your jurisdiction (e.g., "21+" for US alcohol, "18+" for most other products).
  </Card>

  <Card title="Button hierarchy" icon="arrow-pointer">
    Use filled buttons for the confirm action and outlined or text buttons for decline to create clear visual hierarchy.
  </Card>

  <Card title="Backdrop blur" icon="eye">
    Enable backdrop blur to improve focus on the verification prompt and prevent users from interacting with page content before verifying.
  </Card>

  <Card title="Decline destination" icon="link">
    Set the decline URL to an appropriate page—either your homepage, an informational page, or an external site.
  </Card>

  <Card title="Legal compliance" icon="scale-balanced">
    Ensure your age verification meets legal requirements for your jurisdiction and product type. Consult legal counsel if needed.
  </Card>

  <Card title="Mobile testing" icon="mobile">
    Test the popup display and button interactions on mobile devices to ensure usability on smaller screens.
  </Card>
</CardGroup>

## Legal considerations

<Warning>
  **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
</Warning>

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

## Related sections

<Card title="Custom liquid" icon="code" href="/themes/sahara/sections/custom-liquid">
  Add custom age verification logic with additional requirements
</Card>