Add Didit identity verification and age gating to your Shopify store in minutes. The Didit Verify Shopify app installs a theme block you can drop onto any page (account, checkout, custom landing pages) and creates verification sessions server-side — your API key stays inside the embedded app, never exposed to the storefront.Documentation Index
Fetch the complete documentation index at: https://docs.didit.me/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites
- A Shopify store (any plan)
- A Didit Console account with at least one workflow
Step 1: Install the app
- Open the install link: https://admin.shopify.com/oauth/install?client_id=091c43ccd91f610a1e647b0067e03ac1
- Select your store (if you have multiple stores)
- Click Install to add the app to your store
Step 2: Configure Your Didit Credentials
After installation, you’ll be redirected to the Didit Verify Preferences page. Here you’ll connect the app to your Didit account.Get Your API Key
- Log in to the Didit Business Console
- Navigate to Settings → API & Webhooks
- Copy your API key

- Paste the API key into the Didit API Key field in the Shopify preferences
Get Your Workflow ID
- In the Didit Business Console, go to Workflows
- Select the workflow you want to use (or create a new one)
- Copy the Workflow ID (a UUID like
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

- Paste the Workflow ID into the Didit Workflow ID field
Save Your Settings
Click Save Settings. You should see a success message:
Step 3: Add the Verify Button to Your Theme
- In your Shopify admin, go to Online Store → Themes
- Click Customize on your active theme
- Navigate to the page where you want the verification button (e.g., Account page, a custom page)
- Click Add section or Add block
- Go to the Apps tab
- Select Didit Verify
Configuration Options
Preferences Page Settings
These settings are configured in the app preferences (accessible from Apps → Didit Verify in your Shopify admin):| Setting | Description |
|---|---|
| API Key | Your Didit API key (required) |
| Workflow ID | The verification workflow to use (required) |
| Vendor Data Mode | How to identify users in your Didit dashboard: by customer ID, email, or shop+customer |
| Callback URL | Optional webhook URL to receive verification results |
| Language | Verification UI language (auto-detect or specific language) |
| Require Customer Login | If enabled, only logged-in customers can verify |
| Auto-send Customer Data | Prefill verification with customer’s name, email, and address |
Theme Block Settings
These settings are configured in the Shopify theme editor when you select the Didit Verify block:Connection
| Setting | Description |
|---|---|
| Mode | API Session (recommended) — creates unique sessions per user. UniLink — uses a fixed verification URL (no backend needed). |
| UniLink URL | Only used in UniLink mode. Paste your UniLink URL from the Didit Console. |
Display
| Setting | Description |
|---|---|
| Display Mode | Modal — opens verification in a popup overlay. Embedded — shows verification inline below the button. |
| Show close button | Show/hide the X button to close the verification modal |
| Exit confirmation dialog | Ask users to confirm before closing verification |
| Auto-close on completion | Automatically close the modal when verification completes |
| Debug logging | Enable browser console logs for troubleshooting |
Button Appearance
| Setting | Description |
|---|---|
| Button text | Text shown on the button (default: “Verify your Identity”) |
| Success text | Text shown after successful verification (default: “Identity Verified ✓“) |
| Background color | Button background color |
| Text color | Button text color |
| Border radius | Button corner roundness (0–50px) |
| Vertical padding | Top/bottom padding (0–40px) |
| Horizontal padding | Left/right padding (0–60px) |
| Font size | Button text size (10–32px) |
Recommended Setup
For most stores, we recommend:- Mode: API Session (creates unique verification sessions, better tracking)
- Display Mode: Modal (works everywhere, no layout issues)
- Require Customer Login: Enabled (links verification to customer accounts)
- Auto-send Customer Data: Enabled (prefills customer info, faster verification)
Testing
- Preview your theme or visit your store
- Navigate to the page with the Didit Verify button
- Click Verify your Identity
- Complete the verification flow
- Check your Didit Business Console to see the verification result
New Didit accounts receive $10 in free credits for testing. Each verification uses a small amount of credits.
Troubleshooting
Button does nothing when clicked
- Make sure you’ve saved your API Key and Workflow ID in the preferences
- Check that the Workflow ID belongs to the same application as your API Key
- Enable Debug logging in the block settings and check the browser console for errors
Support (24/7)
Our team is available to help you get up and running.WhatsApp Support
Fastest response — reach us directly on WhatsApp.
Send us an email at hello@didit.me.