Troubleshooting & FAQ
Quick fixes for the questions we hear most. Can't find your answer? Open a support ticket.
The popup doesn't show
- Test mode is on — only administrators see the gate. Turn it off on the General tab.
- You are logged in and “Bypass for logged-in users” is on, or you already passed the check. Use Preview or a private window.
- Old page cache — clear WP Rocket, LiteSpeed, Cloudflare or your host's cache.
- Geo-location, a schedule or a display scope may exclude this page or country — check those tabs, or the page's “Age verification” box (it may be set to Never).
The popup shows again on every page
- Your cache plugin may strip cookies — set a custom cookie name it allows (Advanced & Tools).
- “Remember me” is unticked — then the verification lasts only for the browser session.
- Strict server-side verification was just turned on — visitors verified before are asked once more.
Wrong country or everyone gets blocked
Your site is probably behind a proxy or CDN. Open Security & Lockout → Visitor IP detection and compare the two IPs; choose the matching IP source (guide).
“Verify to add to cart” or the My Account tab gives a 404
Go to Settings → Permalinks and click Save Changes once.
ID provider test fails
Check that the key matches the mode (test vs live), that the Stripe restricted key has the permissions listed in the provider guide, and that your domain is added in your AgeChecker.Net account.
Webhook deliveries fail
The URL must be reachable from your server and answer with a 2xx status. Check Recent deliveries for the HTTP code and make sure your firewall allows outgoing requests.
Is the plugin bad for SEO?
No. With SEO search crawler bypass on, real Google and Bing bots (verified by IP) skip the gate, and the popup itself is loaded without blocking your content.
Does it work with page builders and caching plugins?
Yes — it is built for the block editor, Elementor, WooCommerce (classic and block checkout) and caching plugins such as WP Rocket, LiteSpeed Cache and Cloudflare.
How do I move my settings to another site?
Use Advanced & Tools → Download export (JSON) and import it on the other site. On multisite use the network Copy settings tool.
Read next
Was this guide helpful?