Age Verification

How it works

1. When the app starts, it asks the OS for the age range using your age gates before loading your website. iOS may show its own sharing sheet (usually only the first time); Google Play may show its prompt.
2. If you enabled the optional fallback modal, people with no OS signal see a simple "I’m 18 or older" dialog instead.
3. Your website reads the result from window.WebToApp.Compliance, on every page.
4. At any time (for example at sign-up) your website can ask again with requestAgeSignal().

Read the age signal

The result is available as soon as the page loads, and every update fires a WebToAppAgeSignal event:

function handleAgeSignal(signal) {
  if (signal.status === 'PENDING') return; // the app hasn't answered yet

  const isMinor = signal.upperBound !== null && signal.upperBound < 18;
  const isAdult = signal.lowerBound !== null && signal.lowerBound >= 18;

  if (isMinor) {
    showAdultsOnlyScreen();          // or turn on your minor-safe experience
  } else if (isAdult) {
    // adult according to the OS
  } else {
    // no signal (declined, unavailable…): use your own age check
  }
}

if (window.WebToApp && window.WebToApp.Compliance) {
  handleAgeSignal(window.WebToApp.Compliance.getAgeSignal());
}
window.addEventListener('WebToAppAgeSignal', (event) => handleAgeSignal(event.detail));

window.WebToApp.Compliance only exists inside the app with Age verification on. In a normal browser, keep your website’s own age check.

Ask again (on demand)

Request a fresh signal when it matters, for example right before creating an account. It resolves with the same object as getAgeSignal():

const signal = await window.WebToApp.Compliance.requestAgeSignal([18]);
// or, without the helper:
window.FlutterWebView.postMessage(JSON.stringify({ type: 'requestAgeSignal', ageGates: [18] }));
// → answer arrives on the 'WebToAppAgeSignal' event

ageGates is optional (defaults to the gates in the dashboard). Up to 3 ages; iOS uses them to decide which range to share, Google Play uses the ranges configured in Play Console. On-demand requests never show the fallback modal, and keep the previous signal if the OS has nothing new.

Signal fields

Statuses