Local Network Access documentation needs an update

[mkaply]

Page URL

https://firefox-admin-docs.mozilla.org/reference/policies/localnetworkaccess/

What specific section or headline is this issue about?

BlockTrackers/EnablePrompting

What did you expect to see?

LocalNetworkAccess sub-policy interactions are not documented

The LocalNetworkAccess policy handler in Firefox has three behaviors that aren't covered in the docs page:

1. Enabled gates the other boolean sub-policies. If Enabled is not specified in the policy, then BlockTrackers, EnablePrompting, and Locked are silently ignored. SkipDomains is processed independently.

2. BlockTrackers and EnablePrompting policy defaults differ from Firefox runtime defaults. When Enabled is set to true and these sub-keys are not specified, they default to true — overriding the Firefox runtime defaults of false (network.lna.block_trackers, network.lna.blocking).

3. Enabled = false forces the other booleans off. When Enabled is false, BlockTrackers and EnablePrompting are forced to false regardless of any configured values.

Suggested location: a Description/Interaction note in src/content/docs/reference/policies/LocalNetworkAccess.mdx. The behavior is in the LocalNetworkAccess.onBeforeAddons handler.

Do you have anything more you want to share?

No response