sodcalculator

10 Tech How-To

Install Chrome Extensions Manually: Full Guide

Guide 10-31169 · Updated · Step by step

To manually install a Chrome extension, download the .crx or .zip file from the developer’s site, then drag the .crx file onto the chrome://extensions page (or load the unpacked folder for a .zip). This bypasses the Chrome Web Store and is useful for testing, offline installs, or using extensions not listed in the store.

Why Manually Install an Extension?

The Chrome Web Store is the default and safest source for extensions, but there are legitimate reasons to install manually:

  • Offline or air-gapped computers that cannot access the store.
  • Pre-release or beta versions that developers distribute via direct download.
  • Internal company tools not published publicly.
  • Extensions removed from the store due to policy changes (but still available from the author).

Manual installation is also a common step for developers testing their own unpacked extensions before publishing.

How Chrome Extension Files Work

A Chrome extension is essentially a folder containing a manifest.json file (the extension’s metadata and permissions), JavaScript files, HTML pages, icons, and possibly other assets. The Chrome Web Store packages these into a .crx file, which is a signed archive. When you install from the store, Chrome downloads and verifies the .crx automatically.

Manual installation means you handle that file yourself. There are two common formats:

  • .crx file – the signed, packaged format used by the store. You can drag it onto the extensions page.
  • Unpacked folder – the raw source files, typically distributed as a .zip. You extract the zip and load the folder directly.

Chrome treats these differently: .crx files are checked for a valid signature, while unpacked folders are loaded as-is (and Chrome will warn you about this).

Step-by-Step: Install a .crx File Manually

  1. Download the .crx file from the developer’s website. Save it to a known location (e.g., Downloads).
  2. Open Chrome and go to chrome://extensions.
  3. In the top-right corner, enable Developer mode (the toggle may be in the top-left on older versions).
  4. Drag the .crx file from your file manager onto the extensions page.
  5. Click Add extension when the confirmation dialog appears.

If the drag-and-drop doesn’t work, you can also click the Load unpacked button and select the folder containing the extracted extension files (for .zip archives).

Step-by-Step: Install an Unpacked Extension (from .zip)

  1. Download the .zip file and extract it to a permanent folder (e.g., C:\Extensions\my-extension or ~/Extensions/my-extension). Do not delete this folder after installation – Chrome needs it to run the extension.
  2. Open chrome://extensions and enable Developer mode.
  3. Click Load unpacked.
  4. Navigate to the extracted folder and select it.
  5. The extension appears in your list and is immediately active. You can pin it to the toolbar via the puzzle icon.

Common Problems and Fixes

Manual installation can fail for several reasons. Here are the most common issues and how to resolve them:

  • “This extension is not listed in the Chrome Web Store” – This warning appears when dragging a .crx. It’s normal for manual installs; click Keep or Add to proceed.
  • “Package is invalid” – The .crx file may be corrupted or not a valid extension. Re-download it, or try the unpacked method instead.
  • Drag-and-drop doesn’t work – Make sure Developer mode is on. If it still fails, restart Chrome and try again.
  • Extension disappears after restart – For unpacked extensions, the folder must remain in place. If you moved or deleted it, reload it from the extensions page.
  • “Manifest file is missing or unreadable” – The folder you selected doesn’t contain a valid manifest.json at its root. Check that you extracted the zip correctly and selected the right subfolder.

Safety and Security Considerations

Manual installation bypasses Chrome’s built-in review and malware scanning. This means you should only install extensions from sources you trust. Before installing, check:

  • The developer’s reputation – Search for reviews or discussions about the extension.
  • The permissions it requests – If an extension asks for access to all websites or your browsing history when it only needs to modify a specific site, that’s a red flag.
  • The file’s integrity – If the developer provides a checksum (SHA-256), verify it after download.

Once installed, you can review permissions at any time via chrome://extensions → Details → Permissions. If you no longer trust an extension, remove it immediately.

Comparing Manual vs. Web Store Installation

Aspect Chrome Web Store Manual Install
Safety Scanned by Google; lower risk No automated scanning; higher risk
Updates Automatic via Chrome Manual – you must re-download and re-install
Ease One click Several steps; requires Developer mode
Availability Only store-listed extensions Any .crx or unpacked folder
Persistence Survives Chrome reinstall Unpacked extensions may need re-loading after Chrome updates

For most users, the Web Store is the better choice. Manual installation is for specific situations where you need a version not available elsewhere or you’re developing your own extension.

Alternatives to Manual Installation

If you’re trying to install an extension that isn’t on the Web Store, consider these alternatives before resorting to manual installation:

  • Check if the developer offers a store listing – Many extensions are available in the store but not prominently linked. Search the store for the extension name.
  • Use a different browser – Firefox and Edge also support Chrome extensions (Edge can install directly from the Chrome Web Store). If the extension is essential, switching browsers might be simpler and safer.
  • Request the developer to publish – If it’s a small tool, the developer may not have submitted it to the store. Ask them to do so.
  • Use a bookmarklet or userscript – For simple functionality, a bookmarklet or a userscript manager (like Tampermonkey) can achieve similar results without a full extension.

Frequently Asked Questions

Is it legal to manually install a Chrome extension?

Yes, as long as you have the right to use the extension (e.g., it’s open-source or you have the developer’s permission). Chrome allows manual installation by design, though it warns you about the risks.

Will manual extensions update automatically?

No. Extensions installed from the Web Store update automatically. Manual .crx installs may update if the developer provides an update URL in the manifest, but this is rare. Unpacked extensions never update automatically – you must re-download and re-load them.

Can I manually install an extension on Chrome for Android or iOS?

No. Chrome for mobile does not support extensions at all. Manual installation is only available on desktop versions of Chrome (Windows, macOS, Linux, and ChromeOS).

What if the .crx file is blocked by Chrome?

Chrome may block .crx files downloaded from the internet for security. In that case, right-click the file, select “Properties” (Windows) or “Open With” (Mac), and unblock it if there’s an option. Alternatively, use the unpacked method by extracting the .zip.

How do I remove a manually installed extension?

Go to chrome://extensions, find the extension, and click “Remove”. For unpacked extensions, you can also delete the folder – but removing via the extensions page is cleaner.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →