Configure Chrome DoH via Google Workspace

Learn how to deploy DNS-over-HTTPS (DoH) across your managed Chrome browsers using the Google Workspace Admin Console. Push CleanBrowsing's encrypted DNS filtering to all devices in your organization.

Step 1: Open Chrome Browser Settings

Log in to the Google Workspace Admin Console. Navigate to Devices > Chrome > Settings > Users & Browsers.

This section controls Chrome browser policies pushed to all managed devices and users in your organization.

Step 2: Choose Organizational Unit

In the left sidebar, select the organizational unit (OU) or sub-organization you want to apply the DNS-over-HTTPS policy to.

You can apply the setting organization-wide or target specific groups (e.g., students, staff, a specific office).

Step 3: Find the DNS-over-HTTPS Option

Use the search bar at the top of the settings page and search for "DNS". Locate the DNS-over-HTTPS setting in the results.

Click on the setting to expand its configuration options.

Step 4: Configure the DoH Template URL

Set the DNS-over-HTTPS mode to "Enable DNS-over-HTTPS with insecure fallback".

In the DNS-over-HTTPS template field, paste your custom DoH URL from the CleanBrowsing dashboard. You can find this URL by logging in to my.cleanbrowsing.org/dashboard and navigating to your network configuration settings.

Note: The custom DoH URL is unique to your account. Make sure to retrieve it from your CleanBrowsing dashboard before proceeding.

Step 5: Save and Verify

Click Save to apply the policy. The setting will propagate to managed Chrome browsers the next time they check in with the admin console.

To verify on a managed browser, open chrome://settings/security and confirm that:

  • The Use secure DNS toggle is enabled and locked (managed icon shown).
  • The DNS provider shows your CleanBrowsing DoH template URL.
  • The setting cannot be changed by the end user.

Note: This applies to Chrome on all platforms (Windows, macOS, ChromeOS, Linux). Managed browsers will enforce the DoH setting automatically.

Related Guides

Chrome Secure DNS

Configure DNS-over-HTTPS directly in a local Chrome browser.

View Guide
Mosyle (DoH/DoT)

Deploy encrypted DNS filtering via Mosyle MDM on Apple devices.

View Guide
Troubleshooting

Fix common DNS filtering issues and verify your configuration.

View Guide