// google admin

Deploy Blankout with managed policies

Force-install Blankout from the Google Admin console, then use the managed.json policy format to allow specific URLs, add organization-specific blocked URLs, or send students to your own blocked page.

1. Force-install the extension

  1. Sign in to the Google Admin console with an administrator account.
  2. Go to Menu > Devices > Chrome > Apps & extensions > Users & browsers. If you use Chrome Browser Cloud Management, go to Menu > Chrome browser > Apps & extensions > Users & browsers.
  3. On the left, select the organizational unit or group that should receive Blankout. Leave the top organizational unit selected to apply it broadly.
  4. If Blankout is not already listed, click Add > Add from Chrome Web Store, search for extension ID jldpdefbjpioomkpmeeinbpbhjebdeie, select Blankout - Games Blocker, and click Select.
  5. Open Blankout and set Installation policy to Force install.
  6. Under Policy for extensions, paste your policy JSON or upload managed.json.
  7. Click Save.
Required: Blankout only enforces blocking when it is force-installed by Google Admin (or an equivalent enterprise policy). A normal Chrome Web Store install by a student or teacher will not block sites. Set Installation policy to Force install.
Tip: Test on a small organizational unit first. Chrome policy changes can take time to reach managed devices.

2. Policy JSON format

Blankout reads Chrome managed storage. The supported keys are declared in the extension's managed_schema.json file. In the Google Admin console, each policy must be wrapped in a Value object. Do not paste the inner arrays or strings directly.

{
  "AllowedUrls": {
    "Value": [
      "intranet.school.edu",
      "school.edu/approved-games"
    ]
  },
  "BlockedUrls": {
    "Value": [
      "new-games.example.com"
    ]
  },
  "BlockedRedirectUrl": {
    "Value": "https://school.edu/blocked.html"
  },
  "BlockAiOverview": {
    "Value": false
  }
}

The downloadable managed.json template contains safe placeholder values that you can replace or remove.

Note: Blankout does not read managed.json directly. Upload or paste it into the Admin console policy field; Chrome validates the values against the extension's managed schema and delivers them through chrome.storage.managed.

3. Supported policies

Policy Type What it does
AllowedUrls Array of strings Exempts matching pages from Blankout URL checks, game-search checks, Google game widgets, page-title checks, BlockedUrls, and the remote blocklist.
BlockedUrls Array of strings Adds organization-specific domains or URL paths to the blocklist.
BlockedRedirectUrl String Sends blocked pages to your own HTTP or HTTPS page. If empty or invalid, Blankout uses its built-in blocked page.
BlockAiOverview Boolean When true, hides Google AI Overview, related AI result blocks, and the AI Mode tab. Defaults to false (AI Overview stays visible).

URL format

4. Custom blocked page

Set BlockedRedirectUrl when students should see your district's acceptable-use page, an internal warning page, or another managed URL instead of Blankout's default page.

"BlockedRedirectUrl": {
  "Value": "https://school.edu/technology/acceptable-use-blocked"
}
Important: Use a dedicated HTTPS page that students can access and that is not itself blocked by Blankout or your network filter. If the redirect target is unavailable, blocked requests may fail to load.

5. Verify the configuration

  1. On a managed Chrome browser, open chrome://policy.
  2. Click Reload policies.
  3. Find Blankout - Games Blocker and confirm each configured policy has status OK.
  4. Test an allowed URL, a BlockedUrls entry, and a normal blocked game URL.
  5. If a policy does not appear, confirm the extension ID, JSON syntax, organizational unit, and policy propagation time.

Blankout also listens for managed-storage changes, so updated policies are applied without reinstalling the extension after Chrome receives them.

6. Example configurations

Allow a school resource but keep blocking games

{
  "AllowedUrls": {
    "Value": [
      "intranet.school.edu",
      "school.edu/approved-games"
    ]
  }
}

Block an additional site

{
  "BlockedUrls": {
    "Value": [
      "new-games.example.com",
      "example.org/disallowed"
    ]
  }
}

Use a district blocked page

{
  "BlockedRedirectUrl": {
    "Value": "https://school.edu/acceptable-use/blocked"
  }
}

Block Google AI Overview

{
  "BlockAiOverview": {
    "Value": true
  }
}

Leave this unset or false to keep AI Overview visible.