---
title: Load a Chrome Extension in a Live Session | TestingBot
description: Load your own Chrome extension (.crx or .zip) into a live Chrome session
  on Windows, macOS or Linux. Covers uploading the extension, picking it when you
  start a session, and limitations.
source_url:
  html: https://testingbot.com/support/web-live/chrome-extensions
  md: https://testingbot.com/support/web-live/chrome-extensions.md
---

# Load a Chrome Extension in a Live Session

You can start a live Chrome session on a desktop operating system with one of your own Chrome extensions installed, to try it by hand on the browser versions you support. The extension is loaded when the browser starts, the same way the [`load-extension` capability](https://testingbot.com/support/web-automate/selenium/browser-extension) loads it into an automated test.

## Upload your extension

Upload the extension to [TestingBot Storage](https://testingbot.com/support/api/storage#upload) with your own API key and secret. Both a packed `.crx` file and a `.zip` of the unpacked extension (with `manifest.json` at its root) work.

```bash
curl -X POST "https://api.testingbot.com/v1/storage" \
  -u API_KEY:API_SECRET \
  -F "file=@/path/to/extension.zip"
```

## Start a session with it

1. Go to [Live Testing](https://testingbot.com/members/manual/new) and pick a Chrome browser on Windows, macOS or Linux.
2. Open **Session options** and choose your extension under **Chrome extension**.
3. Click **Start session**. Chrome starts with the extension installed.

## Notes

- The list shows the Chrome extensions you uploaded with your own API key, newest first: every `.crx`, and every `.zip` whose `manifest.json` is a Chrome extension. A zip that declares Firefox (`browser_specific_settings.gecko`) or Safari settings, or has "safari" in its filename, is stored as a Firefox or Safari extension and is not listed.
- Extensions load in Chrome on desktop operating systems only. For other browsers, and for mobile devices, the choice is ignored.
- One extension per session. To load several, or to automate tests of your extension, use the [load-extension capability](https://testingbot.com/support/web-automate/selenium/browser-extension).
