MDN will be in maintenance mode on Friday September 22nd, starting at 10 AM Pacific / 5 PM UTC, for about 1 hour.

An Options page enables you to define preferences for your extension that your users can change. Users can access the options page for an extension from the browser's add-ons manager:

The way users access the page, and the way it's integrated into the browser's user interface, will vary from one browser to another.

You can open the page programmatically by calling runtime.openOptionsPage().

Options pages have a Content Security Policy that restricts the sources from which they can load resources, and disallows some unsafe practices such as the use of eval(). See Content Security Policy for more details.

Specifying the options page

To create an options page, write an HTML file defining the page. This page can include CSS and JavaScript files, like a normal web page. This page, from the favourite-colour example, includes a JavaScript file:

<!DOCTYPE html>

    <meta charset="utf-8">

      <label>Favourite colour</label>
      <input type="text" id="colour" >
      <button type="submit">Save</button>
  <script src="options.js"></script>


JavaScript running in the page can use all the WebExtension APIs that the add-on has permissions for. In particular, you can use the storage API to persist preferences.

Package the page's files in your extension.

You also need to include the options_ui key in your manifest.json file, giving it the URL to the page.

"options_ui": {
  "page": "options.html",
  "browser_style": true


The webextensions-examples repo on GitHub, contains several examples of extensions that use an options page:

Document Tags and Contributors

 Contributors to this page: andrewtruongmoz, wbamberg, hellosct1, rebloor
 Last updated by: andrewtruongmoz,