Configurer UI with example options for several test userscripts


UserScripts Configurer is a shared configuration controller for UserScripters' userscripts.

How to use

Configurer is exposed as a global accessible via UserScripters.Userscripts.Configurer. To ensure the Configurer is done loading, including scripts are encouraged to listen to a userscript-configurer-load event on unsafeWindow before hooking:

unsafeWindow.addEventListener("userscript-configurer-load", () => {
    // it is safe to hook into the configurer now

To hook to the Configurer, call its register method with the name of the userscript as its single parameter:

const configurer = UserScripters.Userscripts.Configurer;
const script = configurer.register("Auto Review Comments");

The method will return an instance of Userscript to which options (if any) can be added by calling its option method with 2 parameters. The 1st is the option's name, the 2nd is its configuration. The configurer currently supports 4 types of options (type field):

  • text input
  • checkboxes
  • toggle switch
  • select

Option config interface (as well as the interface of the Configurer itself) is described by our Global Types type definitions package.

// text input option
        def: "Welcome to Stack Overflow",
        title: "Greeting text",
        type: "text",

// checkbox option
script.option("prefer-diff-view", {
    items: [{
        label: "Use diff view",
        value: true
    type: "checkbox",

//toggle option
script.option("prefer-diff-view", {
    selected: true,
    title: "Prefer diff view",
    type: "toggle",

// select option
script.option("style", {
    items: [
        { label: "Simple", value: "simple" },
        { label: "Full", value: "full", selected: true }
    title: "Reference style",
    type: "select",

The Configurer uses a userscript manager-agnostic storage that also works with localStorage if manager storages are inaccessible.


The script is licensed under the GPL-3.0-or-later license.


Latest version: 1.1.0

Install | Minified


Version number means "last tested on":

Chrome Edge Explorer Firefox Opera
✔ 100.0.4896.127 - - - -

Supported userscript managers:

  • Greasemonkey
  • Tampermonkey
  • Violentmonkey


Author: Oleg Valter
Organization: UserScripters

Please, submit bug reports on the source repository.
Before adding a new one, please check if it hasn't been raised before.

You can also drop by to chat, we are a friendly bunch.


Source code is written in TypeScript.

Contributions are welcome, you can always submit a PR here.


You must log in to answer this question.

Browse other questions tagged .