Skip to content
LumaDocs

DocsEveryday browsing

Extensions

Install Chrome extensions from the Chrome Web Store, manage them, and see what Luma doesn’t support yet.

Install an extension

  1. Open chromewebstore.google.com and go to the extension’s page.
  2. Click Add to Chrome, as you would in Chrome.
  3. Luma lists what the extension will be able to do. Click Add extension to install it.

Luma downloads the extension from the Chrome Web Store and checks its signatures before installing it. You can also paste a Web Store link or an extension ID in the field at the top of the Extensions page and click Install.

Use and manage extensions

The Extensions button (in the toolbar, in the dock, or in the sidebar layout in the row at the top of the sidebar) lists your extensions. Click one to open it, choose Pin to toolbar to give it its own button, or Manage extensions to open the Extensions page. You can also reach the page from ⋯ menu › Extensions.

  • Turn off and Turn on an extension without removing it.
  • Details shows its permissions and any errors; Options opens its settings, when it has some.
  • Remove deletes the extension and the data it stored in Luma.
  • Luma checks Web Store extensions for updates every few hours. When an update asks for new permissions, the Extensions page tells you, and Review lets you accept or refuse them.

To hide the Extensions button, turn off Settings › Appearance › Toolbar › Extensions.

Manifest V3 and Manifest V2

Luma runs extensions built with Manifest V3, the current format, and with the older Manifest V2. The Chrome Web Store no longer offers many Manifest V2 extensions to current versions of Chrome. When such an extension has an official replacement by the same developer, Luma offers it instead: for uBlock Origin, that is uBlock Origin Lite.

What works and what doesn’t

Luma provides the Chrome extension APIs most extensions use: content scripts, storage, messaging, toolbar buttons and popups, side panels, tabs and tab groups, windows, cookies, bookmarks, history, downloads, context menus, notifications, keyboard shortcuts, declarativeNetRequest, user scripts, native messaging with desktop apps, proxy, web sign-in and the debugger.

Not availableWhat it affects
tabCapture, desktopCaptureRecording or capturing the screen or a tab
identity.getAuthTokenSigning in with the browser’s Google account
gcmGoogle push messages
enterprise.platformKeys, enterprise.deviceAttributesFeatures for managed company PCs

An extension that asks for one of these is marked Partially supported, and the Extensions page tells you which features won’t work. The full list is under What works and what doesn’t on that page.

  • Luma’s own blocking comes first: extensions that try to block or change requests with webRequest can’t override it.
  • Extensions don’t run in private windows.
  • Each container keeps separate extension data, and extension storage marked as “sync” stays on this computer.

Developer mode

Turn on Developer mode at the top of the Extensions page to get Load unpacked… for an extension folder on your PC, plus extension IDs, Inspect and Reload. Manifest V3 background service workers can’t be inspected: open the extension’s popup or options page instead, and look for errors under Details.