Settings
AgeOnce WordPress plugin configuration
Plugin Settings
After installing the plugin, go to AgeOnce in the WordPress admin sidebar to configure.
If you are evaluating AgeOnce, start with the free plan and use a staging site or a test product category first.
API Credentials
Status
Enable or disable the plugin.
- Enabled — Age verification is active
- Disabled — Plugin does not intercept content, checkout, or store signup
Client ID
Unique identifier of your client in AgeOnce.
- Get it from Dashboard Settings
- Create a new client if you don't have one yet
Client Secret
Secret key for API request authentication.
Never publish the Client Secret! It must remain confidential.
Redirect URI
The plugin automatically uses this callback URL (format ?ageonce_callback=1):
https://yoursite.com/?ageonce_callback=1The exact URL for your site is shown in the plugin settings — copy it and add to allowed Redirect URIs in your Dashboard Settings.
For WordPress, always copy the exact URL shown by the plugin. This avoids problems with www vs non-www, HTTPS, subdirectories, or staging domains.
Test connection
After you enter the Client ID and Client Secret, click Test connection. A successful test confirms the site can reach AgeOnce with those credentials.
WooCommerce customer signup
This block appears when WooCommerce is active. It controls store customer accounts on the My Account page, not the AgeOnce merchant account.
- Require age verification before customers can sign up — off by default. When enabled, a guest must finish AgeOnce verification on the registration form before WooCommerce creates the account.
- Minimum age to create a store account — 16+, 18+, or 21+. Used only while signup verification is on.
WooCommerce must also allow account creation on My Account (woocommerce_enable_myaccount_registration). After a successful signup, the new customer stores verification status, Transaction ID, time, and the required age.
Verification duration
How long a visitor stays verified before they are asked again. The time counts from the moment of verification. You set it separately for restricted content and for checkout.
| Setting | Choices | Default |
|---|---|---|
| Restricted content | Until the browser is closed (24 hours at most), 1 hour, 24 hours, 7 days | 24 hours |
| Checkout and store signup | 1 hour, 24 hours, 7 days, 30 days | 24 hours |
The Checkout and store signup setting appears when WooCommerce is active. It also applies to WooCommerce customer signup.
- Visitors who are not logged in are always asked again after 24 hours at most, because their pass lives in a cookie or session. A longer duration only applies to logged-in WordPress accounts.
- Any pass ends when the visitor logs out.
- A higher verified age still covers a lower requirement. An 18+ result never covers a 21+ requirement.
- To make one customer verify again, open their WordPress user profile, tick Reset this account's age verification, and save. The next restricted page or checkout asks them to verify on every device. Past orders keep their own records.
You are responsible for choosing a duration that meets the requirements that apply to your business. AgeOnce does not provide legal advice.
Content Rules
Content restriction is configured per post type (Pages, Posts, Products, etc.).
For each post type you can:
- Enable/disable — Turn age verification on or off for that content type
- Products only: Also hide product descriptions until verified — Off by default. Product rules still require Verify Age at checkout. Turn this on only if the product page itself should be blocked.
- Allow Manual Locking via Metabox — When enabled, you can protect individual pages, posts, or products. An AgeOnce Protection metabox will appear in the sidebar on the edit screen for each post/page/product. There you can enable protection separately for that specific item, regardless of its category.
- Active Age Groups — Choose which age thresholds apply: 16+, 18+, 21+
- Per-age rules — For each enabled age group (e.g. 18+ Rules), select taxonomy terms (Categories, Product Categories, etc.). Content in those terms will require verification for that age. For Products, that means checkout unless you also hide descriptions.
Example
- Enable Products
- Check 18+ as active age group
- In 18+ Rules, select "Alcohol" in Product Categories
- All products in the Alcohol category, including products assigned only to a child category of Alcohol, will require 18+ verification at checkout
After Configuration
- Save changes
- Add the Redirect URI to Dashboard Settings
- Test by opening a restricted page or adding an age-restricted product to cart and going to checkout