Forge Documentation


This documentation is deprecated, and only kept here to support users of browser extension APIs. If you are using for iOS or Android, see

activations: Inject files into pages

Platforms: Browser

The activations module allows styles and scripts to be injected into webpages with specified URLs.


The activations module must be enabled in config.json as follows:

    "modules": {
        "activations": [
                "patterns": [""],
                "scripts": ["gmail.js"],
                "styles": ["gmail.css"],
                "run_at": "start",
                "all_frames": false

This field specifies when and how your foreground files will be embedded into pages. It is an array of objects with three required keys:

  • patterns is an array of Match Patterns which control on which URLs your app will activate
  • scripts is an array of Javascript files which will be embedded
  • styles is an array of CSS files which will be embedded

As well as an optional keys:

  • run_at optionally defines when your included scripts will be added to the page, must be one of the following:
  • "start" scripts will be run immediately, potentially before the DOM is ready
  • "ready" scripts will run as soon as the DOM is ready
  • "end" (default) scripts will run at some point after the DOM is ready, with no guarantees as to whether or not window.onload will have fired yet or not.
  • all_frames optionally defines whether activations will be run in all frames or just the top level document, by default it is false.


Safari only supports a single object in the activations array.