sodcalculator

10 Tech How-To

Install & Remove Chrome Extensions Manually

Guide 10-35145 · Updated · Step by step

This guide shows you how to install and remove Chrome extensions manually—without using the Chrome Web Store. You’ll learn how to load an unpacked extension from a folder, how to remove it completely, and what to do when things go wrong. This is useful for developers testing their own code, for installing extensions from a trusted source that isn’t on the store, or for cleaning up extensions that won’t uninstall normally.

What You’ll Need

  • A computer running Google Chrome (Windows, Mac, or Linux).
  • The extension files you want to install, usually a folder containing a manifest.json file and other resources (JavaScript, HTML, images).
  • If the extension is a .crx file, you may need to extract it first (see Troubleshooting).
  • Administrator rights on your computer if Chrome is installed in a protected location (rare on personal machines).

Step-by-Step

Part 1: Enable Developer Mode

  1. Open Google Chrome.
  2. In the address bar, type chrome://extensions and press Enter. This opens the Extensions management page.
  3. Look at the top-right corner of the page. There is a toggle switch labeled Developer mode. Turn it on. The switch will turn blue.
  4. Once enabled, a new toolbar appears at the top of the page with three buttons: Load unpacked, Pack extension, and Update.

Part 2: Install an Unpacked Extension

  1. Click the Load unpacked button. A file browser window opens.
  2. Navigate to the folder that contains your extension’s manifest.json file. Do not go inside the folder—select the folder itself.
  3. Click Select Folder (Windows/Linux) or Open (Mac).
  4. Chrome now loads the extension. You’ll see it appear in the list on the Extensions page with its name, version, and description.
  5. If you want the extension to appear in the toolbar, click the puzzle piece icon (Extensions menu) in the top-right of the browser window, find your extension, and click the pin icon next to it.

Part 3: Remove an Extension Manually

  1. Go back to chrome://extensions.
  2. Find the extension you want to remove in the list.
  3. Click the Remove button on that extension’s card. A confirmation dialog appears.
  4. Click Remove again in the dialog. The extension is now uninstalled.
  5. If the extension was loaded as unpacked, you can also simply delete the folder from your computer. Chrome will show an error on the Extensions page until you click the Remove button to clear it.

Part 4: Remove an Extension That Won’t Uninstall

  1. If the Remove button is grayed out or the extension keeps coming back, it might be managed by your organization or installed by another program.
  2. Check if the extension has a small Managed by your organization label. If so, you’ll need to contact your IT admin—you cannot remove it yourself.
  3. If it’s not managed, close Chrome completely.
  4. On Windows, open the Start menu, type %LOCALAPPDATA%\Google\Chrome\User Data\Default\Extensions and press Enter. On Mac, open Finder and go to ~/Library/Application Support/Google/Chrome/Default/Extensions.
  5. Find the folder named after the extension’s ID (a 32-character string). Delete that folder.
  6. Reopen Chrome and go to chrome://extensions. The extension should be gone. If it still appears, click Remove to clear the entry.

Common Mistakes

  • Selecting the wrong folder: When loading unpacked, you must select the folder that directly contains the manifest.json file. If you select a parent folder or go one level too deep, Chrome will show an error like “Manifest file is missing or unreadable.”
  • Forgetting to enable Developer mode: The Load unpacked button only appears after Developer mode is on. If you don’t see it, go back and toggle it.
  • Leaving the unpacked folder on a removable drive: If the extension folder is on a USB stick or network drive, Chrome will lose it when the drive is disconnected. Keep it on your local hard drive.
  • Deleting the folder before removing the extension: If you delete the folder while the extension is still loaded, Chrome will show a broken extension with a “Load error” badge. You must click Remove to clean it up.
  • Assuming .crx files can be loaded directly: The Load unpacked button does not accept .crx files. You need to extract the .crx first (see Troubleshooting).

Tips

  • Keep a backup of your extension folder. If Chrome updates and breaks something, you can easily reload it.
  • Use the Pack extension button to create a .crx file from your unpacked folder. This is handy for sharing with others or installing on another machine.
  • When testing, use Chrome’s Incognito mode to check if the extension works with private browsing. You can enable this by clicking Details on the extension card and toggling “Allow in Incognito.”
  • If you’re developing, use the Reload button (circular arrow) on the extension card after making changes to your code. This is faster than removing and re-adding.
  • Check the extension’s manifest.json for the version field. Chrome will not load a manifest with an invalid version (e.g., missing or non-numeric).

Troubleshooting

“Manifest file is missing or unreadable”

This means Chrome cannot find a valid manifest.json in the folder you selected. Make sure the file exists and is named exactly manifest.json (not manifest.json.txt). Open it in a text editor and confirm it’s valid JSON—no trailing commas, proper quotes. If you downloaded a .crx file, you need to extract it first:

  1. Rename the .crx file to .zip (e.g., extension.crx → extension.zip).
  2. Extract the zip using your operating system’s built-in extractor or a tool like 7-Zip.
  3. You’ll get a folder containing the manifest and other files. Use that folder for Load unpacked.

“This extension is not allowed” or “Policy” errors

This usually means Chrome is blocking the extension because it’s not from the Web Store and you have a policy that restricts that. If you’re on a work or school computer, the admin has set this. On a personal computer, check if you have any “Extensions” policies in your Chrome settings. You can type chrome://policy in the address bar to see if any policies affect extensions. If you see one, you’ll need to remove it (often via the registry on Windows or a configuration profile on Mac).

Extension loads but doesn’t work

Open the extension’s details page by clicking Details on its card. Look for any error messages. Also, open Chrome’s Developer Tools by pressing F12, go to the Console tab, and look for red errors. Common issues: the extension expects a newer Chrome version, missing permissions in the manifest, or the extension’s code has a bug. Check the console for specific file and line numbers.

Extension disappears after restart

This happens if the extension folder was moved, renamed, or deleted. Go to chrome://extensions and look for a card with a “Load error” message. Click Remove to clear it, then reload the extension from its correct location.

Can’t remove an extension at all

If the Remove button is grayed out or missing, the extension is likely managed by policy. Type chrome://management in the address bar to see if your browser is managed. If it is, contact your administrator. If it’s not, try the manual deletion method in Part 4 above. If that still fails, reset Chrome to default settings (Settings > Reset and cleanup > Restore settings to their original defaults) but note this will remove all extensions and reset your startup page and search engine.

Frequently Asked Questions

Is it safe to install extensions manually?

It can be, but you are bypassing Chrome’s security review. Only install extensions from developers you trust, and inspect the code if possible. Malicious extensions can steal passwords, read your browsing history, or inject ads. The Web Store offers some protection, but manual installation has none.

Can I install a .crx file directly?

In current versions of Chrome, dragging a .crx file onto the Extensions page is disabled for security reasons. You must extract it to a folder and use Load unpacked, or use the Pack extension feature to create a new .crx and then drag that (though this is also blocked in newer versions). The reliable method is always Load unpacked.

Will the extension update automatically?

No. Unpacked extensions do not auto-update. You must manually download new versions and reload them. If you pack it as a .crx and host it, you can set up an update URL in the manifest, but that’s advanced.

Does this work on Chrome for Android or iOS?

No. Mobile versions of Chrome do not support extensions at all. This guide is for desktop Chrome (Windows, Mac, Linux).

My extension disappeared after a Chrome update—what happened?

Chrome updates can sometimes disable unpacked extensions if they use old APIs or if the update changes security policies. Go to chrome://extensions and check if the extension is listed as disabled. Click the toggle to enable it. If it shows an error, you may need to update the extension’s code.

Can I install an extension for all users on a computer?

Yes, but it requires administrative setup. You can place the extension folder in a shared location and use Chrome’s policy (ExtensionInstallForcelist) to install it for everyone. This is typically done by IT admins, not individual users. For personal use, just install it in your own profile.

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 →