AgeOnce Docs
WordPress

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.

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=1

The 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.

SettingChoicesDefault
Restricted contentUntil the browser is closed (24 hours at most), 1 hour, 24 hours, 7 days24 hours
Checkout and store signup1 hour, 24 hours, 7 days, 30 days24 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:

  1. Enable/disable — Turn age verification on or off for that content type
  2. 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.
  3. 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.
  4. Active Age Groups — Choose which age thresholds apply: 16+, 18+, 21+
  5. 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

  1. Save changes
  2. Add the Redirect URI to Dashboard Settings
  3. Test by opening a restricted page or adding an age-restricted product to cart and going to checkout

On this page