Chrome Extension Roaming Client Guide

Article author
Minetta Gould
  • Updated

The Google Chrome Extension Roaming Client is a browser-based endpoint agent designed to be used on managed Chromebooks to disallow any circumvention of software.

Just like our other DNSFilter Roaming Clients, the Chrome Extension provides 

  • Granular Reporting
  • Roaming off-network filtering
  • Tagging

The Chrome Extension also supports Chromebook-compatible Mobile Device Management (MDM) deployment to easily filter and protect from these devices. 


  • Devices must be managed in order to run DNSFilter's Chrome Extension
    • Unmanaged devices can easily circumvent or remove the extension and do not send information to DNSFilter
  • The Chrome extension is tested with G Suite deployments but can be deployed with other MDM platforms
    • We will continue to update our documentation as we test
  • Yandex SafeSearch is blocked by the Chrome Extension because it can't enforce filtered searches 

Installation and Deployment

Before installing the DNSFilter Extension, set the Device Network Hostname Template for your enrolled devices to avoid a list of enrolled devices called "[blank]" in your DNSFilter Dashboard. This steps ensures the correct device name and client registration populate on the dashboard.

See Google's device network hostname guide to steps to set the hostname. 

These steps use the Google Admin Dashboard, but other MDM's use a similar extension setup. 

        1. Login to and navigate to Devices 
          a. Select Chrome 
          b. Select Apps & Extension
        2. Select the Organizational Unit (OU) of users to manage the extension
        3. Select Add (➕)
        4. Select Add Chrome Extension by ID
        5. Select From Customer URL 
        6. Enter the following Extension ID and Custom URL:

          Extension ID: ahailcbfmbjeilfjapehbjlclkeffojh
          Custom URL:
        7. Select Save
          a. The OU is now added
        8. Select the Installation Policy
        9. Set it to Force Install
        10. Under Policy for Extensions, enter this JSON (replace "YOUR-SITE-KEY-HERE" with your site key

        11. Select Save

The installation is now complete. When a user in the OU logs into their Chromebook the extension will force-install and register with the site. 

Having issues? See the Chrome Extension Troubleshooting article to address common blocks. 

Version Log

You can find the history of the Chrome Browser Roaming Client release notes on our public changelog.

Was this article helpful?

1 out of 9 found this helpful

Have more questions? Submit a request



Article is closed for comments.