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
On this page
- The short answer
- What Does Developer Mode Do in Chrome?
- How Do You Turn On Developer Mode in Chrome?
- How Do You Load an Unpacked Extension in Chrome?
- Load Unpacked vs Installing From the Chrome Web Store: What's the Difference?
- What Do You Do When Chrome Won't Load Your Unpacked Extension?
- Why Does Chrome Warn That Developer Mode Extensions Can Harm Your Computer?
- Does Developer Mode Work the Same Way on a Chromebook or Android?
- Which Extensions Are Worth Installing Once Developer Mode Is On?
- Should You Turn Developer Mode Off When You're Done?
- 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
.zipor 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.
- Open a new tab and type
chrome://extensionsin the address bar, then pressEnter. - Look at the top-right corner of the page for a toggle labeled Developer mode.
- Click the toggle so it turns on. The change applies immediately, with no confirmation dialog.
- Three new buttons appear at the top of the page: Load unpacked, Pack extension, and Update.
| Before | After |
|---|---|
| Only Chrome Web Store extensions can install | You can also load unpacked folders and .crx files |
| No developer buttons on chrome://extensions | Load unpacked, Pack extension, and Update buttons appear |
| Extension cards hide ID and version details | Each 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.
- Get the extension's source folder onto your computer — downloaded, cloned from GitHub, or unzipped — so it contains a
manifest.jsonfile at its top level. - With Developer mode on, click Load unpacked on the
chrome://extensionspage. - In the file picker, select the folder itself, not the manifest.json file and not a parent folder above it, then click Select Folder.
- 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.
- After you edit the code, return to
chrome://extensionsand 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 | Chrome Web Store | |
|---|---|---|
| Where it comes from | A folder on your computer | A published, reviewed listing |
| Review or policy check | None — Chrome installs it as-is | Passes Google's review process |
| Updates | Manual — reload after every change | Automatic in the background |
| Survives a browser restart | Yes, until removed or Chrome is reset | Yes |
| Best for | Building or testing your own extension | Everyday, 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.
| Error message | What it means | Fix |
|---|---|---|
| "Manifest file is missing or unreadable" | You selected the wrong folder | Select 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 format | Check 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 folder | Remove the extension and use Load unpacked again |
| "Could not load icon" | manifest.json points to an icon file that doesn't exist | Fix the icon path in manifest.json, then click Update |
| Red "Errors" button on the extension card | Chrome caught a manifest or permissions problem | Click 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
-
Developer Tools
Inspects React component trees and props directly in DevTools; only useful if the extension or site UI you're building actually uses React.
-
JSON FormatterFree
Developer Tools
Pretty-prints raw JSON so API responses from your extension's background script are readable; purely a viewing convenience, it doesn't edit anything.
-
Cookie-EditorFree
Developer Tools
Views, edits, and deletes cookies for the site you're testing against; the trade-off is it needs the cookies permission on every site you visit.
-
TampermonkeyFree
Developer Tools
Runs userscripts without a manifest.json at all, a faster loop than Load unpacked for small tweaks; scripts still need reading before you trust one from elsewhere.
-
WappalyzerFreemium
Developer Tools
Shows the tech stack behind any site you're testing against, useful for sizing up what framework you're working with; deeper detail sits behind its paid tier.
-
Window ResizerFree
Developer Tools
Snaps the window to fixed sizes for testing a popup or options page at different widths; it's a convenience shortcut, not a full device emulator.
-
ViolentmonkeyFree
Developer Tools
An open-source alternative to Tampermonkey for running userscripts while you prototype logic before wiring it into a real manifest-based extension.
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
- React Developer ToolsInspect React component trees and props.
- JSON FormatterPretty-print JSON right in the browser.
- Cookie-EditorView, edit, create, and delete browser cookies for any site right from the toolbar
- TampermonkeyRun custom userscripts that inject code into any site you visit.
- WappalyzerSee the tech stack behind any website.
- Window ResizerSnap the browser window to preset or custom sizes for side-by-side viewing.
- ViolentmonkeyOpen-source userscript manager that executes custom scripts on web pages.
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.