The Firefox Enterprise Policies

Mozilla has integrated this new feature in Firefox version 60. It is meant to help enterprise admins, who deploy Firefox as software package to computers in their organization.

The Enterprise Policy feature provides two new ways to configure Firefox (besides autoconfig aka mozilla.cfg):

  • A config file named policies.json, which must be placed in the program directory.
  • Windows Group Policy Objects (GPO)


  • Firefox version 60 or later.
  • In Windows some options require Firefox ESR or domain-joined PCs.

It is currently unclear how Firefox detects the domain membership, and whether it must be an Active Directory domain.

Howto use the admx templates

  1. Copy firefox.admx to C:\Windows\PolicyDefinitions
  2. Copy firefox.adml to C:\Windows\PolicyDefinitions\en-US
  3. Run gpedit.msc or RSAT (Remote Server Administration Tools).

Howto use create the json file

A Generator addon was published (german), more info.

Howto not document a new feature

My quest to find a web page which describes this new feature lead to this rant:

The new Wiki page (specifically made to document this new feature)

only points to

which only points to

which points to different places, amongst them

which only points to

which contains a tiny bit of information, and points to a readme on github

And there the first sentence is the only one that says what this is all about.

Hey Mozilla, I'm not impressed!

There are of course a lot of things missing in that sentence. For example that this is supposed to replace autoconfig. And that in Windows several of these options only work if either the ESR version is used, or the configured PCs are members of a Windows Domain. Also how do the two methods relate to each other, and to autoconfig: which does precedence?

Lets hope that eventually Mozilla will write some decent documentation for this new feature.

P.S. No, I'm not gonna read the source, to extract the required infos from there.


  • 2018-05-31 cleanup
  • 2018-05-30 add howto use the admx templates, and links to generator and source.
  • 2018-05-25 new