VerifyHuman for Shopify — Documentation
Welcome to the VerifyHuman Shopify App documentation. This guide covers everything you need to install, configure, and manage identity and age verification for your Shopify store.
What is VerifyHuman?
VerifyHuman is a Shopify app that adds real-time identity verification, age verification, and bot detection to your store. It uses camera-based verification powered by the VerifyHuman API to ensure your customers are real people who meet your compliance requirements.
Key Features
- Age Gate (L2) — Block access to age-restricted products or your entire store until visitors verify their age with a selfie or self-attestation.
- Identity Verification (L3) — Full KYC verification requiring a government-issued ID and selfie match. Ideal for high-value items and regulated products.
- Human Check (L1) — Bot detection for signup, review, and contact forms using camera-based liveness checks.
- Pre-Checkout Guard — Require identity verification before checkout for tagged products, with support for all checkout methods including Shop Pay, Apple Pay, and Google Pay.
- Flexible Triggering — Apply verification to your entire store, specific collections, tagged products, or individual pages.
- Guest and Account Support — Verification works for both guest shoppers (via signed tokens) and logged-in customers (via metafield persistence).
- Shopify Theme Editor Integration — Enable and configure widgets directly from the Shopify Theme Editor with no code required.
Three Verification Levels
| Level | Name | What It Does |
|---|---|---|
| L1 | Human Check | Quick camera-based liveness check to block bots and automated attacks |
| L2 | Age Verification | Verifies the customer is of legal age (18+, 21+, or 25+) using selfie analysis or self-attestation |
| L3 | Identity Verification | Full KYC with government ID document + selfie facial comparison |
Quick Links
| Topic | Description |
|---|---|
| Getting Started | Prerequisites, install flow, and first configuration |
| Installation | Detailed app installation guide |
| Theme App Extension Setup | Enable embeds and blocks in your theme |
| Age Gate | Age verification configuration and trigger modes |
| Identity Verification | KYC verification, checkout guard, and token flow |
| Human Verification | Bot detection for forms |
| Tags and Triggers | Tag-based triggering, metafields, and level computation |
| Settings Reference | Every setting in the dashboard and theme editor |
| Advanced Settings | Custom selectors, thresholds, diagnostics, and cart threshold |
| Testing Your Setup | Step-by-step validation for each feature |
| Troubleshooting | Common issues and solutions |
| FAQ | Frequently asked questions |
| Reviewer Test Mode | How test mode works for Shopify app review |
How It Works
- Install the app from the Shopify App Store or via direct install link.
- Enter your VerifyHuman API key in the app settings (get one at app.verifyhuman.io).
- Enable widgets in your Shopify Theme Editor — Age Gate and Human Check as App Embeds, Identity Verification as an App Block.
- Tag products that require verification using the
vh_requires_idvtag orverifyhuman.requires_idvmetafield. - Customers verify when they encounter restricted content or products. Verification results are stored as signed tokens (guests) or customer metafields (accounts).
Two Configuration Modes
Simple Mode (Recommended)
Quick setup with three choices:
- Select a minimum verification level (L1, L2, or L3)
- Set an age threshold (18+, 21+, or 25+)
- Optionally set a high-value cart threshold to auto-upgrade to L3
Advanced Mode
Full control over each verification type independently:
- Enable/disable Age Gate, Identity, and Human Check separately
- Configure trigger modes, scopes, session duration, and more
- Set product-level and collection-level restrictions
Privacy and Compliance
VerifyHuman is designed with privacy in mind:
- No image storage: Selfie and ID images are processed in real time and are not stored after verification completes.
- Encrypted credentials: Your VerifyHuman API key is encrypted with AES-256-GCM before being stored.
- GDPR compliant: The app handles Shopify's mandatory GDPR webhooks for data requests, customer data deletion, and shop data deletion.
- Transparent disclosures: Built-in privacy notices inform customers about what data is collected and how it is used.
- Configurable retention: Verification results can be set to expire after a configurable number of days.
Support
- VerifyHuman Dashboard: app.verifyhuman.io
- API Documentation: Available in the VerifyHuman dashboard under Settings
- Privacy Policy: verifyhuman.io/privacy
- Terms of Service: verifyhuman.io/terms