AIControls

Configure AI controls. For more information, see Block generative AI features with Firefox AI controls on support.mozilla.org.

Compatibility

Firefox	Firefox ESR	Firefox Enterprise
Available since 149.0.2	Available since 153	Available since 149.0.2

CCK2 Equivalent: N/A
Preferences Affected: browser.ml.chat.enabled, browser.ml.chat.page, browser.ai.control.sidebarChatbot, browser.translations.enable, browser.ai.control.translations, pdfjs.enableAltText, browser.ai.control.pdfjsAltText, browser.ml.linkPreview.enabled, browser.ai.control.linkPreviewKeyPoints, browser.tabs.groups.smart.userEnabled, browser.ai.control.smartTabGroups, browser.ai.control.smartWindow

Examples

policies.json

{
  "policies": {
    "AIControls": {
      "Default": {
        "Value": "blocked",
        "Locked": true
      },
      "Translations": {
        "Value": "available",
        "Locked": false
      }
    }
  }
}

JSON schema

AIControls JSON schema

{
  "type": "object",
  "properties": {
    "Default": {
      "type": "object",
      "properties": {
        "Value": {
          "type": "string",
          "enum": [
            "available",
            "blocked"
          ]
        },
        "Locked": {
          "type": "boolean"
        }
      }
    },
    "Translations": {
      "type": "object",
      "properties": {
        "Value": {
          "type": "string",
          "enum": [
            "available",
            "blocked"
          ]
        },
        "Locked": {
          "type": "boolean"
        }
      }
    },
    "PDFAltText": {
      "type": "object",
      "properties": {
        "Value": {
          "type": "string",
          "enum": [
            "available",
            "blocked"
          ]
        },
        "Locked": {
          "type": "boolean"
        }
      }
    },
    "SmartTabGroups": {
      "type": "object",
      "properties": {
        "Value": {
          "type": "string",
          "enum": [
            "available",
            "blocked"
          ]
        },
        "Locked": {
          "type": "boolean"
        }
      }
    },
    "LinkPreviewKeyPoints": {
      "type": "object",
      "properties": {
        "Value": {
          "type": "string",
          "enum": [
            "available",
            "blocked"
          ]
        },
        "Locked": {
          "type": "boolean"
        }
      }
    },
    "SidebarChatbot": {
      "type": "object",
      "properties": {
        "Value": {
          "type": "string",
          "enum": [
            "available",
            "blocked"
          ]
        },
        "Locked": {
          "type": "boolean"
        }
      }
    },
    "SmartWindow": {
      "type": "object",
      "properties": {
        "Value": {
          "type": "string",
          "enum": [
            "available",
            "blocked"
          ]
        },
        "Locked": {
          "type": "boolean"
        }
      }
    }
  }
}

Values

Each key controls the availability of a specific AI feature. The following AI feature keys are available:

• Default: Controls the default state for AI features listed below, unless they are explicitly configured in the policy.
• Translations: Controls AI-powered page translations.
• PDFAltText: Controls AI-generated alt text for images in PDF documents.
• SmartTabGroups: Controls AI-powered tab grouping suggestions.
• LinkPreviewKeyPoints: Controls AI-generated key point summaries shown in link previews.
• SidebarChatbot: Controls the AI chatbot panel in the Firefox sidebar.
• SmartWindow: Controls AI-powered window arrangement features.

All keys accept the following sub-keys:

• Value:
  • available makes the feature accessible to users and it can be enabled or disabled.
  • blocked the feature is disabled and users won't see the feature. For on-device AI, any models already downloaded are removed.
• Locked: if true, the user cannot change the setting.

Windows (GPO)

Software\Policies\Mozilla\Firefox\AIControls\Default\Value = "available" | "blocked"
Software\Policies\Mozilla\Firefox\AIControls\Default\Locked = 0x1 | 0x0
Software\Policies\Mozilla\Firefox\AIControls\Translations\Value = "available" | "blocked"
Software\Policies\Mozilla\Firefox\AIControls\Translations\Locked = 0x1 | 0x0
Software\Policies\Mozilla\Firefox\AIControls\PDFAltText\Value = "available" | "blocked"
Software\Policies\Mozilla\Firefox\AIControls\PDFAltText\Locked = 0x1 | 0x0
Software\Policies\Mozilla\Firefox\AIControls\SmartTabGroups\Value = "available" | "blocked"
Software\Policies\Mozilla\Firefox\AIControls\SmartTabGroups\Locked = 0x1 | 0x0
Software\Policies\Mozilla\Firefox\AIControls\LinkPreviewKeyPoints\Value = "available" | "blocked"
Software\Policies\Mozilla\Firefox\AIControls\LinkPreviewKeyPoints\Locked = 0x1 | 0x0
Software\Policies\Mozilla\Firefox\AIControls\SidebarChatbot\Value = "available" | "blocked"
Software\Policies\Mozilla\Firefox\AIControls\SidebarChatbot\Locked = 0x1 | 0x0
Software\Policies\Mozilla\Firefox\AIControls\SmartWindow\Value = "available" | "blocked"
Software\Policies\Mozilla\Firefox\AIControls\SmartWindow\Locked = 0x1 | 0x0

macOS

<dict>
  <key>AIControls</key>
  <dict>
    <key>Default</key>
    <dict>
      <key>Value</key>
      <string>available | blocked</string>
      <key>Locked</key>
      <true/> | <false/>
    </dict>
    <key>Translations</key>
    <dict>
      <key>Value</key>
      <string>available | blocked</string>
      <key>Locked</key>
      <true/> | <false/>
    </dict>
    <key>PDFAltText</key>
    <dict>
      <key>Value</key>
      <string>available | blocked</string>
      <key>Locked</key>
      <true/> | <false/>
    </dict>
    <key>SmartTabGroups</key>
    <dict>
      <key>Value</key>
      <string>available | blocked</string>
      <key>Locked</key>
      <true/> | <false/>
    </dict>
    <key>LinkPreviewKeyPoints</key>
    <dict>
      <key>Value</key>
      <string>available | blocked</string>
      <key>Locked</key>
      <true/> | <false/>
    </dict>
    <key>SidebarChatbot</key>
    <dict>
      <key>Value</key>
      <string>available | blocked</string>
      <key>Locked</key>
      <true/> | <false/>
    </dict>
    <key>SmartWindow</key>
    <dict>
      <key>Value</key>
      <string>available | blocked</string>
      <key>Locked</key>
      <true/> | <false/>
    </dict>
  </dict>
</dict>