Set Helperbird JSON Policy for Individual Users

Administrative guide for deploying Helperbird in your organization. Manage licenses, deployments, and team accessibility.

·

This guide shows you how to apply Helperbird's JSON policy for just one user in your Google Workspace. This is perfect for testing before rolling out to everyone, or when only specific users need Helperbird.

Before you start: You'll need administrator access to the Google Admin Console and Helperbird's extension ID: ahmapmilbkfamljbpgphfndeemhnajme


Adding Helperbird for the User

Step 1: Access User Settings

Log into admin.google.com and go to DevicesChromeApps & extensionsUsers & browsers. In the left panel, select the specific user you want to configure (not an organizational unit).


Step 2: Add Helperbird

If Helperbird isn't already listed for this user, click + and select Add from Chrome Web Store. Search for Helperbird or paste the extension ID: ahmapmilbkfamljbpgphfndeemhnajme


Step 3: Set Installation Policy

Set the Installation policy to Force install (recommended) so the extension installs automatically for this user. Click Save, then click on the Helperbird tile to open its settings.

Tip: Force install ensures the user gets Helperbird without having to install it manually.


Applying the JSON Policy

Step 1: Open the Policy Editor

In the Helperbird settings panel, find the Policy for extensions section (it might also be called "Additional settings" or "Extension settings"). Click Edit or Add to open the JSON editor.


Step 2: Paste the JSON Policy

Copy and paste this JSON, replacing YOUR SUBSCRIPTION KEY with the actual subscription key for this user:

{
  "subKey": {
    "Value": "YOUR SUBSCRIPTION KEY"
  },
  "isAdminControl": {
    "Value": false
  }
}

Step 3: Save Your Changes

Click Save in the JSON editor, then click Save again at the top right to confirm all changes for this user.

Tip: Set "isAdminControl": true only if this user needs admin-level controls in Helperbird. Most users should have this set to false.


Verifying and Troubleshooting

Step 1: Check on the User's Device

Have the user sign into their managed Chrome browser. Helperbird should be installed automatically (check Chrome menu → Extensions).


Step 2: Test the Settings

Ask the user to open Helperbird and confirm that features tied to their subscription key are unlocked and working correctly.


Step 3: Force a Policy Refresh if Needed

If the settings don't appear right away:

  • On Windows/Mac/Linux: Restart Chrome or go to chrome://policy and click Reload policies
  • On ChromeOS: Sign out and sign back in, or restart the device

Common issues:

  • Wrong user selected: Double-check you applied settings at the user level, not an organizational unit
  • JSON formatting errors: Make sure all braces, quotes, and commas are correct
  • Wait a few minutes: Policies can take a few minutes to propagate

Video Tutorial

Coming soon.


Validate Your Policy

Before deploying, use our JSON Policy Validator to check for errors, validate feature codes, and see exactly what each setting does.


Need Additional Help?

Ran into a snag while getting started? No worries at all! Just reach out to our friendly Helperbird support team, and we'll help you smooth things out in no time.

What People Are Saying

Join over 1,000,000 people who use Helperbird every day.

I am an assistive technology consultant for 30 school districts. I am adding Helperbird to the list of reading resources that I have available.

Denise Young

Denise Young

Parent

I purchased this for my daughter who has been having a lot of difficulty accessing the online work set remotely by her teachers during our National Lockdown because of Covid-19. Her dyslexia was really hindering her ability to complete tasks and keep up which in turn led to increased anxiety levels...a really horrid place to be in during a global pandemic! Helper bird has been a vast help and I fully recommend it and wish more schools knew about it. Thank You Helper Bird.

Michelle Howard-Price

Michelle Howard-Price

Assistive technology specialist

Best website reading enhancer

Sandeep K.

Sandeep K.

Domain Trainer

Saw it mentioned at Cast last night! Love Immersive Reader.

Taylor Coffee

Taylor Coffee

Firefox user

The free version of this is so great and helpful to a LOT of people...but the upgraded version is next level:)

Mia Laudato

Mia Laudato

Helperbird user

Let me tell you, I didn't know how badly I needed this until I got it. It was much like when I got glasses, I had just assumed that was how everyone saw the world...then it wasn't. Thank you Helperbird for the efforts you put forth in this lovely extension for everyone to use. The fact that you can use so much on the free just goes to show that this is something to help aid people not just some money grab. However with the pricing it still couldn't be a money grab. Thank you all again for the efforts you put forth so others can enjoy the internet more fully.

Matthew Burns

Matthew Burns

Health care worker

Helperbird logo: Stylized owl with large yellow eyes and a beige face, against a green background.

Download Helperbird

Make browsing easier and more accessible with tools like Text to Speech, Immersive Reader, and more.