# Browser Extension Installation and Configuration

### Web Browser Support <a href="#block-a6be45e4f45c418db4caacb2a2cd5e67" id="block-a6be45e4f45c418db4caacb2a2cd5e67"></a>

PixieBrix officially supports the last two major versions of the following browsers:

* Google Chrome
* Microsoft Edge
* Island: *official support available on Enterprise plans*

PixieBrix, by and large, works on any Chromium-based browser. If you have questions or need official support, please contact <support@pixiebrix.com>.

#### Known Limitations <a href="#block-a6be45e4f45c418db4caacb2a2cd5e67" id="block-a6be45e4f45c418db4caacb2a2cd5e67"></a>

* The [Side Panel](https://developer.chrome.com/docs/extensions/reference/api/sidePanel) is not available when running Chromium-based browsers in "Application Mode" using the `--app` flag

#### Browser Support Matrix/Behavior Differences

| Web Browser    | Description                                                                                                                                                                                                                                                                                                                                                                                                                               |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Microsoft Edge | <p>Side Panel: Microsoft Edge <a href="https://github.com/w3c/webextensions/issues/588">automatically closes tab-specific panels when switching tabs</a> <br><br>PixieBrix does <a href="https://learn.microsoft.com/en-us/dotnet/desktop/wpf/app-development/xbap-faq">not support legacy XAML Browser Applications (XBAP)</a><br><br>On Microsoft Edge in "Application Mode", attempting to open the Side Panel crashes the browser</p> |
| Opera          | Managed Storage: Opera does not support managed storage for enterprise configuration                                                                                                                                                                                                                                                                                                                                                      |
| Island         | <p>The Dev Tools are disabled by default, so the PixieBrix Page Editor is not accessible <br><br>The Dev Tools can be enabled for users/groups in the Security Settings in the Island management console</p>                                                                                                                                                                                                                              |

### Browser Extension Distribution Scenarios <a href="#block-a6be45e4f45c418db4caacb2a2cd5e67" id="block-a6be45e4f45c418db4caacb2a2cd5e67"></a>

There are two approaches to distributing the PixieBrix Browser Extension:

* **Scenario #1: Self-Serve Installation from Chrome Web Store**. Team members manually install the browser extension as needed
  * If your organization blocks extension by default, [add the PixieBrix extension to Chrome's “Allow List”](https://chromeenterprise.google/policies/?policy=ExtensionSettings) so that each team member can individually install the PixieBrix browser extension. See [browser-extension-installation-policy](https://docs.pixiebrix.com/enterprise-it-setup/browser-extension-installation-and-configuration/browser-extension-installation-policy "mention")
  * Your team members will follow the instructions at [installing-the-pixiebrix-chrome-browser-extension](https://docs.pixiebrix.com/how-to/installing-the-pixiebrix-chrome-browser-extension "mention")
* **Scenario #2: Automatic Installation**. Add PixieBrix [to Chrome's list of "Force Install" extensions](https://chromeenterprise.google/policies/#ExtensionInstallForcelist) to have Chrome automatically install the browser extension on team members' browsers.&#x20;
  * Follow instructions at [browser-extension-installation-policy](https://docs.pixiebrix.com/enterprise-it-setup/browser-extension-installation-and-configuration/browser-extension-installation-policy "mention")
  * Your team members will follow the instructions at [linking-your-pixiebrix-account](https://docs.pixiebrix.com/activating-mods/linking-your-pixiebrix-account "mention"). Or configure SSO to authenticate users via automatically [setting-up-saml-sso](https://docs.pixiebrix.com/enterprise-it-setup/authentication/setting-up-saml-sso "mention")
* **Scenario #3: Virtual Desktop Infrastructure.** If you use a VDI, such as Citrix, refer to the Automatic Installation instructions
  * Follow instructions at [browser-extension-installation-policy](https://docs.pixiebrix.com/enterprise-it-setup/browser-extension-installation-and-configuration/browser-extension-installation-policy "mention")

### PixieBrix Browser Extension Details <a href="#block-27eee7cdf100411f977f3cd123e56e77" id="block-27eee7cdf100411f977f3cd123e56e77"></a>

{% hint style="info" %}
To ensure your users install the correct extension, we recommend having them install it via [https://app.pixiebrix.com](https://app.pixiebrix.com/) or using your browser’s enterprise "Force install" functionality. Manual install instructions are available in the [installing-the-pixiebrix-chrome-browser-extension](https://docs.pixiebrix.com/how-to/installing-the-pixiebrix-chrome-browser-extension "mention") docs.
{% endhint %}

**Stable Release Channel**

* ID: `mpjjildhmpddojocokjkgmlkkkfjnepo`
* [Chrome Web Store: PixieBrix](https://chrome.google.com/webstore/detail/pixiebrix/mpjjildhmpddojocokjkgmlkkkfjnepo)

**BETA Release Channel**

* ID: `mpapkmgkphbggmlekkfnoilmafnbfile`
* [Chrome Web Store: PixieBrix BETA](https://chromewebstore.google.com/detail/pixiebrix-beta/mpapkmgkphbggmlekkfnoilmafnbfile)

**Enterprise White-labeled Extension Builds**

Contact <support@pixiebrix.com> for your extension details

### Browser Vendor Enterprise Management Documentation <a href="#block-8fee7ead6ff348c490f96a0d39f2da23" id="block-8fee7ead6ff348c490f96a0d39f2da23"></a>

#### Google Chrome <a href="#block-b9ff3bdcbbf74f73bcd101c0417ac452" id="block-b9ff3bdcbbf74f73bcd101c0417ac452"></a>

Refer to the Google documentation for how your organization manages access to Chrome Browser Extensions:

* [Google Chrome Enterprise Help: Managing Extensions in your Enterprise](https://support.google.com/chrome/a/answer/9296680?hl=en)
* [Set Chrome policies for users or browsers](https://support.google.com/chrome/a/answer/2657289?hl=en)

#### Microsoft Edge <a href="#block-c53a7516786b487fadf334e77ab849b7" id="block-c53a7516786b487fadf334e77ab849b7"></a>

{% hint style="info" %}
To force install PixieBrix in Microsoft Edge, the browser must be managed by the organization
{% endhint %}

Refer to the Microsoft documentation on managing access to the Edge Browser Extensions

* [Manage Microsoft Edge extensions in the enterprise](https://learn.microsoft.com/en-us/deployedge/microsoft-edge-manage-extensions)