> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getprimo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Chrome

> Deploy managed Chrome settings, extensions, and homepage across macOS and Windows devices.

## Platform compatibility

| macOS | Windows | Linux | iOS / iPadOS | Android |
| ----- | ------- | ----- | ------------ | ------- |
| ✅     | ✅       |       |              |         |

## How to set it up

<Steps>
  <Step title="Enable the Primo Extension (optional)">
    Toggle on **Primo Extension** to automatically discover SaaS applications and prevent shadow IT by scanning logins made with employees' professional Google accounts.
  </Step>

  <Step title="Add extensions">
    Under **Custom extension ID**, click **Add extension** to install Chrome extensions on targeted devices. Find each extension ID in the URL of its Chrome Web Store page.
  </Step>

  <Step title="Configure the homepage">
    Enter a URL to set as the default homepage.

    * Toggle **Define "New tab page" as homepage** to use Chrome's new tab page instead.
    * Toggle **Show home button** to display the home button in the toolbar.
  </Step>

  <Step title="Add bookmarks (optional)">
    Click **Add bookmark** to deploy managed bookmarks to all targeted devices.
  </Step>

  <Step title="Set restore behavior on startup">
    Use the **Restore behavior on startup** dropdown to control what Chrome does when it launches.
  </Step>

  <Step title="Toggle additional settings (optional)">
    * **Password manager**: allow users to save and autofill passwords in Chrome's built-in password manager.
    * **Passkeys in password manager**: allow users to create and use passkeys in Chrome's built-in password manager.
    * **Default browser setting**: let Chrome check whether it is the default browser and prompt users to set it as default.
  </Step>

  <Step title="Select targeting">
    Choose which devices to apply the control to: all devices, specific device groups, or a custom target.
  </Step>
</Steps>

## Modify or remove the control

Disable the control from the profile settings. Disabling stops enforcement but does not remove existing configurations from devices.

## How it works

Primo pushes Chrome policies as a managed configuration profile (on macOS) or via registry keys (on Windows). Chrome detects these policies at startup and applies them automatically. Users cannot override managed settings.

A **Managed by your organization** notice appears in Chrome when enterprise policies are active — this is expected behavior.