Set up Legacy Browser Support for Mac

For administrators who manage Chrome browser on Mac for a business or school.

As an administrator, you can automatically switch users from Chrome browser to an alternative browser when they use managed Apple Mac computers. Use the Google Admin console to set policies to specify which URLs open in an alternative browser. For example, you can ensure that browser visits to the internet use Chrome bowser, but visits to your organization’s intranet use Apple Safari.

Step 1: Review policies

Expand to see the full set of policies and descriptions.

Full set of policies and descriptions

Policy	Description and settings
AlternativeBrowserParameters	Specifies the parameters to be passed to the alternative browser’s executable. If this policy is turned on, the provided parameters are used when the alternative browser is invoked. You can use the special placeholder `${url}` to specify where the URL should appear in the command line. You don't have to specify the placeholder if it's the only argument or if it should be appended to the end of the command line. Unset: Only the URL is passed as a parameter to the alternative browser.
AlternativeBrowserPath	Specifies the program to be used as an alternative browser. You can specify a file location or use one of these variables: `${firefox}`—Mozilla^® Firefox^® `${opera}`—Opera^® `${safari}`—Safari Unset: For Mac, the default alternative browser is Safari, `${safari}`.
BrowserSwitcherDelay	Specifies the length of time, in milliseconds, that it takes to open the alternative browser. During this time, users see a message that they are switching browsers. If there are issues, users see an error message on the page. Unset: The URL immediately opens in the alternative browser without without showing users a message that they are switching browsers.
BrowserSwitcherEnabled	Enables the Legacy Browser Support feature. If this policy is turned on, users can open some URLs in an alternative browser, such as Safari. If this policy is turned on, you must configure at least one of these policies: BrowserSwitcherExternalSitelistUrl BrowserSwitcherUrlList BrowserSwitcherUseIeSitelist Unset: Chrome browser will not open URLs in an alternative browser.
BrowserSwitcherExternalGreylistUrl	Specifies the URL of the XML file that contains the list of URLs that do not trigger a browser switch. You can use a file on your local system using the file:// schema. Or, use a file on a remote server over HTTP or HTTPS. Unset: Chrome browser doesn’t use an XML file to control which URLs do not trigger a browser switch.
BrowserSwitcherExternalSitelistUrl	Specifies the URL of the XML file that contains the list of URLs that open in an alternative browser. You can use a file on your local system using the file:// schema. Or, use a file on a remote server over HTTP or HTTPS. Unset: Chrome browser doesn’t use an XML file to control whether URLs open in an alternative browser.
BrowserSwitcherKeepLastChromeTab	Specifies whether to close Chrome browser after the last tab in the window switches to the alternative browser. Chrome browser tabs automatically close after switching to the alternative browser. If this policy is turned off and the last tab is open in the window before switching, Chrome browser closes completely. Unset: After switching to the alternative browser, at least one tab stays open in Chrome browser.
BrowserSwitcherUrlGreylist	Specifies a list of website URLs that open in Chrome browser or an alternative browser and do not trigger a browser switch. Unset: URLs open in Chrome browser, unless specified in BrowserSwitcherExternalSitelistUrl, BrowserSwitcherUrlList , or BrowserSwitcherUseIeSitelist.
BrowserSwitcherUrlList	Specifies a list of website URLs that open in an alternative browser. Unset: No URLs are listed in the Chrome policy.

Step 2: Configure Legacy Browser Support

Sign in to your Google Admin console.
Sign in using your administrator account (does not end in @gmail.com).
In the Admin console, go to Menu DevicesChromeSettings. The User & browser settings page opens by default.
If you signed up for Chrome Enterprise Core, go to Menu Chrome browserSettings.
(Optional) To apply the setting only to some users and enrolled browsers, at the side, select an organizational unit (often used for departments) or configuration group (advanced). Show me how
Group settings override organizational units. Learn more
Go to Legacy Browser Support.
To open URLs in an alternative browser, such as Microsoft Internet Explorer:
1. Click Legacy Browser Support.
2. Select Enable Legacy Browser Support.
3. Click Save. Or, you might click Override for an organizational unit.
  To later restore the inherited value, click Inherit (or Unset for a group).
(Optional) To use an XML file to specify which URLs open in an alternative browser:
1. Click Legacy Browser Support site list.
2. Enter the URL of the XML file.
3. Click Save. Or, you might click Override for an organizational unit.
  To later restore the inherited value, click Inherit (or Unset for a group).
(Optional) To open specific URLs in Safari:
1. Click Websites to open in alternative browser.
2. Enter the URLs of pages to open in an alternative browser.
3. Click Save. Or, you might click Override for an organizational unit.
  To later restore the inherited value, click Inherit (or Unset for a group).
(Optional) Specify Safari as the alternative browser:
1. Click Alternative browser path.
2. Enter the location of the browser’s executable file or ${safari}.
3. Click Save. Or, you might click Override for an organizational unit.
  To later restore the inherited value, click Inherit (or Unset for a group).

Step 3: (Optional) Customize Legacy Browser Support

(Optional) To apply the setting only to some users and enrolled browsers, at the side, select an organizational unit (often used for departments) or configuration group (advanced). Show me how
Group settings override organizational units. Learn more
Go to Legacy Browser Support.
(Optional) To show a message that lets users know that they are switching browsers:
1. Click Delay before launching alternative browser.
2. Enter the number of seconds to show the message before opening Safari.
3. Click Save. Or, you might click Override for an organizational unit.
  To later restore the inherited value, click Inherit (or Unset for a group).
(Optional) To use an XML file to specify which URLs do not trigger a browser switch:
1. Click URL to list of websites to open in either browser.
2. Enter the URL of the XML file.
3. Click Save. Or, you might click Override for an organizational unit.
  To later restore the inherited value, click Inherit (or Unset for a group).
(Optional) To allow URLs to open on a specific page in either browser, such as a single sign-on (SSO) page:
1. Click Websites to open in either browser.
2. Enter the URLs that can open in both browsers.
3. Click Save. Or, you might click Override for an organizational unit.
  To later restore the inherited value, click Inherit (or Unset for a group).
(Optional) To pass parameters to Safari:
1. Click Alternative browser parameters.
2. Enter the parameters that you want to pass on to Safari'’s executable file.
3. Click Save.
(Optional) To keep Chrome browser open after the last tab in the window switches to the alternative browser:
1. Click Keep last Chrome tab.
2. Select Keep at least one Chrome tab open.
3. Click Save. Or, you might click Override for an organizational unit.
  To later restore the inherited value, click Inherit (or Unset for a group).

Step 4: Verify policies are applied

Check Chrome browser policies

After you apply any Chrome policies, users need to restart Chrome browser for the settings to take effect. Check users’ devices to make sure the policy was applied correctly.

On a managed device, go to chrome://policy.
Click Reload policies.
Check the Show policies with no value set box.
For the policies that you set, make sure that:
1. The status is set to OK.
2. The policy values match what you set in the policy.

Check Legacy Browser Support configuration

You can check to see which browser opens specific URLs.

On a managed device, go to chrome://browser-switch/internals.
In the URL Checker box, enter the URL to see which browser opens it.
Under Sitelist, review the list to see which URLs open in the alternative browser.
Under Greylist, review the list to see which URLs open in either browser.

Was this helpful?

How can we improve it?