How the App Embed Works

AgeVerify Shield uses Shopify's Theme App Extension system to inject the age verification modal into your store. This means zero code changes to your theme.

Architecture

The app uses an App Embed (not an App Block). This is important because:

App Embeds inject into the tag of every page
No need to manually place blocks on individual pages
Works with all Online Store 2.0 themes and most legacy themes

How It Works Internally

The embed loads your rules and theme configuration from Shopify metafields
It detects the current page context: product handle, collection, vendor, product type, tags
It detects the visitor context: country, market, locale
The client-side rule engine evaluates all rules in priority order
If a matching rule is found, it loads the assigned theme
The verification modal is rendered with CSS custom properties
"Remember Me" state is checked via localStorage

Data Source

All configuration is stored in two Shopify metafields:

Metafield	Purpose
`shop.metafields.age_verification.app_config`	Rules, themes, settings
`shop.metafields.age_verification.subscription`	Current plan & branding status

These are updated automatically whenever you change settings in the dashboard.

Country Detection

The app detects the visitor's country in this priority order:

Shopify Localization – localization.country.iso_code
Shopify Geolocation API – browsing context suggestions
Browser Language – fallback from navigator language

Enabling the Embed

Go to Online Store → Themes → Customize → App embeds and toggle "🔞 Age Verification" on. That's it!