Customize Firefox using policies.json

Revision Information
  • Revision id: 162090
  • Created:
  • Creator: Wesley Branton
  • Comment: Added Windows-specific pointer to GP article
  • Reviewed: No
  • Ready for localization: No
Revision Source
Revision Content

On Linux, policy support is implemented using a JSON file called policies.json. This file goes into the distribution directory where Firefox is installed. This directory is not normally there, so you might have to create it.

On macOS, policy support is implemented using a JSON file called policies.json. This file goes into a directory called distribution in the Firefox.app/Contents/Resources directory. This directory is not normally there, so you might have to create it.

Note: This article does not apply to the Windows operating systems. To customize policies for Firefox on Windows, refer to Customize Firefox using Group Policy (Windows).

On macOS and Linux, policy support is implemented using a JSON file called policies.json. on macOS, this file goes into the distribution directory where Firefox is installed. On Linux, this file goes into a directory called distribution in the Firefox.app/Contents/Resources directory. This directory is not normally there, so you might have to create it.

The policies.json file looks like this: 

{
 "policies": {
   "BlockAboutConfig": true
 }
}

In this example, we are setting the policy BlockAboutConfig to true which means that the user will not have access to about:config.

For the latest information on our policies and more details about specific policies is available in the README on our GitHub repository:

https://github.com/mozilla/policy-templates/blob/master/README.md