--- /dev/null
+**IMPORTANT**: These files are in active development along with the policies in Firefox. To get the policy information that corresponds to a specific release, go to https://github.com/mozilla/policy-templates/releases.
+
+Starting with Firefox 64 and Firefox ESR 60.4, Firefox supports configuration files on macOS.
+
+An example plist file with all options is available here:
+
+https://github.com/mozilla/policy-templates/blob/master/mac/org.mozilla.firefox.plist
+
+If you want to set specific options from the command line, we also provide flattened shortcuts to any item that is nested in the plist file.
+
+For example, this policy:
+```
+{
+  "policies": {
+    "Homepage": {
+      "URL": "http://example.com/"
+    }
+  }
+}
+```
+which would be set in the plist file like this:
+```
+       <key>Homepage</key>
+       <dict>
+               <key>URL</key>
+               <string>http://example.com</string>
+    </dict>
+```
+can be set via the command line like this:
+```
+defaults write org.mozilla.firefox Homepage__URL -string "http://example.com"
+```
+Before any command line policies will work, you need to enable policies like this:
+```
+defaults write org.mozilla.firefox EnterprisePoliciesEnabled -bool TRUE
+```
 
 <plist version="1.0">
 <dict>
        <key>EnterprisePoliciesEnabled</key>
-       <true/>
+       <false/>
        <key>AppUpdateURL</key>
        <string>https://www.example.com/update.xml</string>
        <key>Authentication</key>
        <key>Homepage</key>
        <dict>
                <key>URL</key>
-               <string>about:policies</string>
+               <string>http://example.com</string>
                <key>Locked</key>
                <true/>
                <key>Additional</key>