WebsiteFilter

Block websites from being visited.

Compatibility

Firefox	Firefox ESR	Firefox Enterprise
Available since 60	Available since 60	Available since 149

As of Firefox 83 and Firefox ESR 78.5, file: URLs are supported.

CCK2 Equivalent: N/A
OMA-URI: WebsiteFilter
Preferences Affected: N/A

Examples

policies.json

{
  "policies": {
    "WebsiteFilter": {
      "Block": [
        "<all_urls>"
      ],
      "Exceptions": [
        "http://example.org/*"
      ]
    }
  }
}

JSON schema

WebsiteFilter JSON schema

{
  "type": "object",
  "contentMediaType": "application/json",
  "properties": {
    "Block": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "Exceptions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

Values

WebsiteFilter expects an array of Match Patterns, as described in https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Match_patterns. The arrays are limited to 1000 entries each.

• If you want to block all URLs, you can use the value <all_urls> or the pattern *://*/* (matching <scheme>://<host><path>). A single wildcard (*) as a value is not sufficient.
• For specific protocols, use https://*/* or http://*/*.

Windows (GPO)

Software\Policies\Mozilla\Firefox\WebsiteFilter\Block\1 = "<all_urls>"
Software\Policies\Mozilla\Firefox\WebsiteFilter\Exceptions\1 = "http://example.org/*"

macOS

<dict>
  <key>WebsiteFilter</key>
  <dict>
    <key>Block</key>
    <array>
      <string><all_urls></string>
    </array>
    <key>Exceptions</key>
    <array>
      <string>http://example.org/*</string>
    </array>
  </dict>
</dict>

See also

• URI schemes on MDN