Setting Helperbird Policies in Enterprise Environments

This guide shows administrators how to configure Helperbird settings across your organization using enterprise policies. You can control subscription keys, the kiosk floating button, and admin permissions on Windows, ChromeOS, and macOS platforms.

Before you start: You'll need administrator access to your organization's management tools and Helperbird's extension ID: ahmapmilbkfamljbpgphfndeemhnajme

Understanding Policy Settings

Helperbird supports three key policy settings that you can configure for your organization:

subKey (Subscription Key)

• Your Helperbird Pro subscription key
• Authenticates and activates Pro features across the enterprise
• Ensures all users have access without individual subscriptions

isAdminControl (Admin Control)

• Controls whether settings can be changed by users (true/false)
• When set to true, only admins can modify Helperbird settings
• Helps maintain uniformity and compliance

floatingButton (Floating Button)

• Shows a floating Helperbird button on every page, bottom-left by default (true/false)
• Useful in kiosk or exam environments where the browser toolbar is hidden
• Requires isAdminControl to be set to true

Configuring Policies on Windows

Step 1: Open Group Policy Editor

Search for gpedit.msc in the Start menu and open the Group Policy Editor. Navigate to User Configuration → Administrative Templates → Google → Google Chrome → Extensions.

Step 2: Configure the Extension Policy

Find Configure extension installation policy, right-click, and select Edit. Add Helperbird's extension ID: ahmapmilbkfamljbpgphfndeemhnajme

Step 3: Apply JSON Configuration

In the Additional Policies for Chrome section, paste this JSON configuration (replace YOUR SUBSCRIPTION KEY with your actual subscription key):

{
	"subKey": "YOUR SUBSCRIPTION KEY",
	"isAdminControl": true
}

Note the shape. On Windows the values are flat, as above. The {"Value": …} wrapper you may have seen elsewhere belongs only to the Google Admin console's "Policy for extensions" field. Using the wrapper here nests the value one level too deep, and Helperbird reads nothing. The ChromeOS section below uses the wrapper because that one goes through Google Admin.

Refresh the policy across your network to apply the settings to all users.

Tip: Set isAdminControl to false to hand control back to users. This removes all admin-managed values (including subKey).

Configuring Policies on ChromeOS

Step 1: Access Admin Console

Log into admin.google.com (opens in a new tab) and navigate to Devices → Chrome → Apps & extensions → Users & browsers. Select the Organizational Unit where you want to apply Helperbird settings.

Step 2: Add the Extension

In the Extensions section, select Managed Extensions. Add Helperbird's extension ID: ahmapmilbkfamljbpgphfndeemhnajme

Step 3: Apply JSON Configuration

In the ExtensionSettings section, paste this JSON configuration (replace Your_Pro_Subscription_Key_Here with your actual subscription key):

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

Click Save to apply the settings to all users in the selected OU.

Tip: Note that ChromeOS uses a slightly different JSON structure with "Value" fields for each setting.

Configuring Policies on macOS

Step 1: Access Management Tools

Use Apple's Profile Manager or your organization's Mobile Device Management (MDM) solution. Navigate to the configuration profile creation section.

Step 2: Force-install the extension

In a configuration profile, add a custom settings payload for the preference domain com.google.Chrome that force-installs Helperbird:

<dict>
 <key>ExtensionInstallForcelist</key>
 <array>
 <string>ahmapmilbkfamljbpgphfndeemhnajme;https://clients2.google.com/service/update2/crx</string>
 </array>
</dict>

Step 3: Apply the managed configuration

On macOS, Chrome reads an extension's managed configuration from a separate preference domain: com.google.Chrome.extensions.<extension-id>. Add a second custom settings payload for com.google.Chrome.extensions.ahmapmilbkfamljbpgphfndeemhnajme (replace the key with your own):

<dict>
 <key>subKey</key>
 <string>Your_Pro_Subscription_Key_Here</string>
 <key>floatingButton</key>
 <true/>
 <key>isAdminControl</key>
 <true/>
</dict>

Deploy the configuration profile to your macOS devices.

Tip: Using Jamf Pro? See the step-by-step Deploy Helperbird with Jamf Pro guide. Change <true/> to <false/> to hide the floating button or hand control back to users.

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. Reach out to our friendly Helperbird support team, and we'll help you smooth things out in no time.