Parental Controls: Web Content Filter

com.apple.familycontrols.contentfilter

The payload that configures the parental control web content filters.

macOS 10.7+

Not available with User Enrollment · Only one instance per profile

Configuration Keys (10)

Key	Type	Title	Description	Default	Range
`restrictWeb`required If 'true', enables web content filters.	boolean	Limit access to websites	If 'true', enables web content filters.	—	—
`whitelistEnabled`deprecated macOS · deprecated 15.2 Use 'allowListEnabled' instead. Default: false	boolean	Enable site allowlist	Use 'allowListEnabled' instead.	false	—
`siteWhitelist`deprecated macOS · deprecated 15.2 Use 'siteAllowList' instead. Depends on: whitelistEnabled ∈ [true]	array	Site Allowlist	Use 'siteAllowList' instead. Depends on: whitelistEnabled ∈ [true]	—	—
`siteWhitelistItem` A dictionary defining a site for the allow list.	dict	Site Allowlist Item	A dictionary defining a site for the allow list.	—	—
`address`required The site prefix, including http(s) scheme.	string	Site address prefix	The site prefix, including http(s) scheme.	—	—
`pageTitle` The site page title.	string	Page Title	The site page title.	—	—
`useContentFilter` If 'true', filters content automatically. Default: false	boolean	Use built in content filter	If 'true', filters content automatically.	false	—
`filterWhitelist`deprecated macOS · deprecated 15.2 Use 'filterAllowList' instead.	array	Content Filter Allowlist	Use 'filterAllowList' instead.	—	—
`filterWhitelistItem`required An allowed site.	string	Allowlist URL	An allowed site.	—	—
`filterBlacklist`deprecated macOS · deprecated 15.2 Use 'filterDenyList' instead.	array	Content Filter Backlist	Use 'filterDenyList' instead.	—	—
`filterBlacklistItem`required A disallowed site.	string	Blacklist URL	A disallowed site.	—	—
`allowListEnabled` macOS 15.2+ If 'true', enables web content filters. Default: false	boolean	—	If 'true', enables web content filters.	false	—
`siteAllowList` macOS 15.2+ An array of sites that defines an allow list. If specified, this defines additional allowed sites besides those in the automated allow list and deny list, including disallowed adult sites. The device requires this key if 'allowListEnabled' is 'true'.	array	—	An array of sites that defines an allow list. If specified, this defines additional allowed sites besides those in the automated allow list and deny list, including disallowed adult sites. The device requires this key if 'allowListEnabled' is 'true'.	—	—
`siteAllowListItem` A dictionary defining a site for the allow list.	dict	—	A dictionary defining a site for the allow list.	—	—
`address`required The site prefix, including the 'http(s)' scheme.	string	—	The site prefix, including the 'http(s)' scheme.	—	—
`pageTitle` The site page title.	string	—	The site page title.	—	—
`filterAllowList` macOS 15.2+ The array of URLs that defines an allow list. When 'restrictWeb' and 'useContentFilter' are enabled, only URLs in the allow list are available to the user.	array	—	The array of URLs that defines an allow list. When 'restrictWeb' and 'useContentFilter' are enabled, only URLs in the allow list are available to the user.	—	—
`filterAllowListItem`required An allowed site.	string	—	An allowed site.	—	—
`filterDenyList` macOS 15.2+ The array of URLs that defines a deny list. When 'restrictWeb' and 'useContentFilter' are enabled, no URLs in the deny list are available to the user.	array	—	The array of URLs that defines a deny list. When 'restrictWeb' and 'useContentFilter' are enabled, no URLs in the deny list are available to the user.	—	—
`filterDenyListItem`required A disallowed site.	string	—	A disallowed site.	—	—