Submit an extension

↑↓ move · ↵ open · Tab filter · Esc close

How-to guide

How to Enable Developer Mode in Chrome and Load an Unpacked Extension

How-to

How to Enable Developer Mode in Chrome and Load an Unpacked Extension

Illustration of an unpacked extension being slotted into a browser with developer mode switched on
On this page
  1. The short answer
  2. What Does Developer Mode Do in Chrome?
  3. How Do You Turn On Developer Mode in Chrome?
  4. How Do You Load an Unpacked Extension in Chrome?
  5. Load Unpacked vs Installing From the Chrome Web Store: What's the Difference?
  6. What Do You Do When Chrome Won't Load Your Unpacked Extension?
  7. Why Does Chrome Warn That Developer Mode Extensions Can Harm Your Computer?
  8. Does Developer Mode Work the Same Way on a Chromebook or Android?
  9. Which Extensions Are Worth Installing Once Developer Mode Is On?
  10. Should You Turn Developer Mode Off When You're Done?
  11. Frequently asked

The short answer

To enable Developer Mode in Chrome, open chrome://extensions and switch on the Developer mode toggle in the top-right corner. This reveals a Load unpacked button you can use to install an extension straight from a folder on your computer, without publishing it to the Chrome Web Store.

What Does Developer Mode Do in Chrome?

Developer Mode is a setting on the chrome://extensions page that lets Chrome install extensions from a local folder instead of only from the Chrome Web Store. It's the switch behind every developer tools extension before it's published anywhere.

You don't need it to use extensions from the Chrome Web Store — only to load unpacked source code, install a .crx file directly, or run a Tampermonkey script that lives on your disk instead of in a store listing.

  • You're building your own extension and want to see changes without publishing anything.
  • A developer sent you a .zip or a GitHub link to test a build before it's listed.
  • You're following a coding tutorial that has you load a sample folder as you go.
  • You need a fix or a feature the published version of an extension doesn't have yet, and a maintainer has shared an unreleased branch.

When you actually need this

Skip Developer Mode if you just want an extension from the Chrome Web Store — install it normally from the store listing. Turn it on only when you're building an extension, testing a build a developer sent you directly, or running a tool with no store listing yet.

How Do You Turn On Developer Mode in Chrome?

Turn on Developer Mode by opening chrome://extensions and flipping the toggle in the top-right corner of the page — it takes four clicks and Chrome doesn't ask you to confirm or restart.

  1. Open a new tab and type chrome://extensions in the address bar, then press Enter.
  2. Look at the top-right corner of the page for a toggle labeled Developer mode.
  3. Click the toggle so it turns on. The change applies immediately, with no confirmation dialog.
  4. Three new buttons appear at the top of the page: Load unpacked, Pack extension, and Update.
What changes when Developer mode is on
BeforeAfter
Only Chrome Web Store extensions can installYou can also load unpacked folders and .crx files
No developer buttons on chrome://extensionsLoad unpacked, Pack extension, and Update buttons appear
Extension cards hide ID and version detailsEach card shows its ID, version, and an Errors button

Two other ways to get to the same page

Click the puzzle-piece icon in the toolbar, then Manage extensions — that opens chrome://extensions directly. See Google's own guide to managing extensions if the menu looks different on your version of Chrome.

Once an unpacked extension is loaded, Chrome adds a persistent banner reading something like "Disable developer mode extensions," with a button to turn Developer mode off in one click. That's expected — it's the same reminder every profile with an unpacked extension gets, not a sign anything is wrong.

If the toggle is greyed out

A workplace or school-managed Chrome profile can block Developer mode entirely through an administrator policy. If clicking the toggle does nothing, that's almost always the cause — sign in with a personal Google account or ask whoever manages the device to enable it, since there's no user-side workaround.

How Do You Load an Unpacked Extension in Chrome?

Loading an unpacked extension means pointing Chrome at a folder that contains a manifest.json file, with Developer mode already switched on.

  1. Get the extension's source folder onto your computer — downloaded, cloned from GitHub, or unzipped — so it contains a manifest.json file at its top level.
  2. With Developer mode on, click Load unpacked on the chrome://extensions page.
  3. In the file picker, select the folder itself, not the manifest.json file and not a parent folder above it, then click Select Folder.
  4. Chrome adds a card for the extension immediately, with no reload needed. If the icon doesn't show in the toolbar, click the puzzle-piece icon and pin it.
  5. After you edit the code, return to chrome://extensions and click the circular Update icon on the extension's card to load your changes.

Only load code you trust

An unpacked extension runs with whatever permissions its manifest requests, with none of the review that a published Chrome extension goes through. Read the manifest before loading anything you didn't write yourself.

Click Details on the extension's card to reach two toggles worth knowing about: Allow access to file URLs, needed if the extension has to read local file:// pages, and Allow in Incognito, off by default for every extension including unpacked ones. Neither is required just to load and test a typical extension.

To debug the code itself, click Inspect views: service worker (or background page on older manifests) on the extension's card. That opens a dedicated DevTools window with console.log output and breakpoints for the extension's background script, separate from the DevTools you'd open on a normal web page.

Load Unpacked vs Installing From the Chrome Web Store: What's the Difference?

Load unpacked installs whatever is in a folder, with no review. Installing from the Chrome Web Store installs a reviewed listing that updates itself. Here's how the two compare.

Load unpacked vs the Chrome Web Store
Load unpackedChrome Web Store
Where it comes fromA folder on your computerA published, reviewed listing
Review or policy checkNone — Chrome installs it as-isPasses Google's review process
UpdatesManual — reload after every changeAutomatic in the background
Survives a browser restartYes, until removed or Chrome is resetYes
Best forBuilding or testing your own extensionEveryday, ongoing use

There's no in-between setting that gives you automatic updates without a store listing, and no way to submit an unpacked folder for review without going through the normal Chrome Web Store developer registration first. If an extension is genuinely useful past your own testing, publishing it is what gets it automatic updates and out of the Developer mode warning banner for anyone else who installs it.

What Do You Do When Chrome Won't Load Your Unpacked Extension?

Most load failures come down to picking the wrong folder or an outdated manifest. Here's what each error actually means and how to fix it.

Common errors when loading an unpacked extension
Error messageWhat it meansFix
"Manifest file is missing or unreadable"You selected the wrong folderSelect the folder that directly contains manifest.json, not one above or below it
"Manifest version 2 is deprecated"The extension still targets an old manifest formatCheck the Manifest V3 basics or ask the developer for an updated build
"This extension may have been corrupted"Files changed after Chrome first indexed the folderRemove the extension and use Load unpacked again
"Could not load icon"manifest.json points to an icon file that doesn't existFix the icon path in manifest.json, then click Update
Red "Errors" button on the extension cardChrome caught a manifest or permissions problemClick Errors on the card to read the exact line-level issue

If an extension loads without an error but simply doesn't do anything, check the Inspect views link on its card first — a broken background script often fails silently with nothing visible except a stack trace in that console. A stale cached copy of the folder can also cause odd behavior; removing the extension and loading it fresh usually clears that.

Why Does Chrome Warn That Developer Mode Extensions Can Harm Your Computer?

Chrome shows that warning because Developer Mode installs skip the Chrome Web Store's review process entirely — nothing has checked the code but you. The banner isn't a bug; it's Chrome being upfront about what Developer mode actually removes.

Unpacked extension
An extension loaded from a folder on disk instead of installed from a packaged .crx file or the Chrome Web Store.
manifest.json
The required file at the root of an extension's folder that declares its name, version, permissions, and entry points.
Extension ID
The unique string Chrome generates for each extension; unpacked extensions can get a new ID if you move or re-select the folder.
Pack extension
A Developer mode button that bundles a folder into a distributable .crx file plus a .pem private key.
Service worker
The background script that runs an extension's logic outside any web page; Manifest V3 extensions use one instead of a persistent background page.
Allow access to file URLs
A per-extension toggle, off by default, that lets an extension read local file:// pages instead of only http and https ones.

The warning also shows up because Chrome can't apply the same automatic malware scanning to an unpacked folder that it runs against every Chrome Web Store submission. That scanning, along with the human policy review, is what normally catches an extension that requests far more access than its description explains — an unpacked build simply hasn't been through it yet, no matter how trustworthy the source looks.

If you're weighing an unpacked build against a published listing, check what the permission actually allows before you decide — the risk is almost always in the permissions requested, not the installation method itself.

Does Developer Mode Work the Same Way on a Chromebook or Android?

No — browser-level Developer mode and ChromeOS's own Developer Mode are two different things that happen to share a name. The chrome://extensions toggle only changes how the browser installs extensions. Switching a Chromebook itself into Developer Mode is a device-level change that wipes local data and needs a full powerwash to undo.

On a Chromebook, the browser toggle works exactly as described above — load unpacked extensions the same way you would on Windows or Mac. See our Chromebook extension picks for what's worth installing day to day, alongside anything you build yourself.

Chrome for Android and Chrome for iOS don't support extensions at all, with or without Developer mode — there's no chrome://extensions page on either mobile app. If you need extension-like features on a phone, see what's actually possible with Chrome extensions on Android and iPhone instead of hunting for a mobile developer toggle that doesn't exist.

A Chromebook running the Linux (Crostini) container is a partial exception worth knowing about: code you edit inside that container and load unpacked into the regular Chrome browser behaves exactly like it would on desktop Chrome elsewhere, since it's still the same desktop-class browser under the hood.

Which Extensions Are Worth Installing Once Developer Mode Is On?

A handful of ordinary, Chrome Web Store extensions make building and debugging your own code faster once Developer mode is on. None of these need to be loaded unpacked — install them the normal way.

Extensions worth having once Developer mode is on

Should You Turn Developer Mode Off When You're Done?

Not necessarily — leaving Developer Mode on indefinitely doesn't slow Chrome down or expose anything by itself. The actual risk is whatever unpacked extension you loaded while it was on, not the toggle.

To turn it off, go back to chrome://extensions and click the same toggle. Chrome keeps any unpacked extensions installed; it just hides the Load unpacked, Pack extension, and Update buttons until you switch it back on.

Turning Developer mode off does disable any unpacked extensions that are still loaded — their cards stay on the page but show as inactive, since Chrome won't run code it can no longer let you reload or inspect. Switch the toggle back on and they reactivate exactly as they were, with no need to load them again.

Removing an unpacked extension

Click Remove on its card in chrome://extensions, the same as removing any other extension. Turning off Developer mode alone doesn't uninstall it — Chrome just stops letting you reload it until the mode is back on.

Extensions mentioned in this guide

Frequently asked

Where exactly is Developer mode in Chrome?

It's a toggle in the top-right corner of the chrome://extensions page. Type that address into any tab, or click the puzzle-piece icon in the toolbar and choose Manage extensions to get there.

Why can't I find the Developer mode toggle on my version of Chrome?

It's always in the top-right corner of chrome://extensions, but a narrow browser window can push it below the fold. Widen the window or zoom out with Ctrl+- if you don't see it.

Does turning on Developer mode make Chrome less secure by itself?

No. The toggle alone changes nothing; it only makes it possible to load unpacked extensions. The security risk comes from what you choose to load with it, not from switching it on.

What happens if I try to load a folder without a manifest.json file?

Chrome shows a "Manifest file is missing or unreadable" error and refuses to install anything. Make sure manifest.json sits directly inside the folder you select, not in a subfolder.

Can I load an unpacked extension without turning on Developer mode first?

No. The Load unpacked button only appears once Developer mode is switched on; there's no way to install a local folder as an extension with it off.

Is Chrome's Developer mode the same as a Chromebook's Developer Mode?

No, they're unrelated despite the shared name. The browser toggle only affects extension installs; ChromeOS Developer Mode is a device setting that wipes local data and requires a powerwash to reverse.

Will Chrome automatically disable an unpacked extension I loaded?

Chrome can disable an unpacked extension if you turn Developer mode off or if the extension's files go missing or become unreadable. It won't disable one just for running for a long time.

Can I use extensions loaded with Developer mode on Chrome for Android or iPhone?

No. Chrome on Android and iOS doesn't support extensions at all, so there's no chrome://extensions page or Developer mode toggle on either mobile app.

How do I see my changes after editing an unpacked extension's code?

Go to chrome://extensions and click the circular Update icon on that extension's card. Chrome reloads the extension from the folder without needing a full browser restart.

What's the actual difference between Load unpacked and Pack extension?

Load unpacked installs a folder directly for testing. Pack extension bundles that same folder into a distributable .crx file and a .pem key, which is a separate step for sharing a build outside the Chrome Web Store.

Do I need Developer mode to run Tampermonkey or Violentmonkey userscripts?

No. Both install normally from the Chrome Web Store and manage userscripts through their own dashboard — Developer mode is only needed if you're loading the extension itself unpacked.

How do I turn off Developer mode in Chrome once I'm finished testing?

Return to chrome://extensions and click the same Developer mode toggle to switch it off. Any unpacked extensions stay installed but can't be reloaded until you turn the mode back on.

Sources

  1. Google Chrome Help — Manage your extensions
  2. Chrome for Developers — Extension development basics
  3. Chrome for Developers — Chrome Web Store program policies