# WebContentFilter The payload that configures web content filters. ``` object WebContentFilter ``` ## Discussion Specify `com.apple.webcontent-filter` as the payload type. The system matches URLs using string-based matching. A URL matches an allow list, deny list, or permitted list pattern if the exact characters of the pattern appear as a substring of the URL requested in the web browser. For example, if the system doesn’t allow `test.com/a`, it blocks `test.com/a`, `test.com/apple`, and `test.com/a/b`. The system matches list entries that terminate with a `/` character explicitly; if the system blocks or allows `test.com/a/`, it blocks or allows `test.com/a` and `test.com/a/b`. Matching discards a `www` subdomain prefix if present, so if the system doesn’t allow `www.test.com`, it also blocks `m.test.com`. All filtering options are active simultaneously. The system only permits URLs and sites that pass all rules. ### Profile availability ||| |--------------------------|---------------------------------| |Device channel |iOS, macOS, Shared iPad, visionOS| |User channel |NA | |Allow manual install |iOS, macOS, visionOS | |Requires supervision |NA | |Requires user-approved MDM|NA | |Allowed in user enrollment|iOS, visionOS | |Allow multiple payloads |iOS, macOS, Shared iPad, visionOS| ### Profile example ```plist PayloadContent AutoFilterEnabled DenylistURLs https://notallowedname.company.com FilterBrowsers FilterSockets FilterType BuiltIn PermittedURLs https://example.company.com PayloadIdentifier com.example.mywebcontentfilterpayload PayloadType com.apple.webcontent-filter PayloadUUID fb5d598f-0a96-4b77-9702-9edfc3417601 PayloadVersion 1 PayloadDisplayName Web Content Filter PayloadIdentifier com.example.myprofile PayloadType Configuration PayloadUUID b510e0c6-dc81-4b62-88d0-6a3ef82925e7 PayloadVersion 1 ``` ## Topics ### Objects [`WebContentFilter.AllowListBookmarksItem`](/documentation/DeviceManagement/WebContentFilter/AllowListBookmarksItem) The bookmark in the allow list of the web content filter. [`WebContentFilter.URLFilterParameters`](/documentation/DeviceManagement/WebContentFilter/URLFilterParameters-data.dictionary) A dictionary containing URL filter parameters. [`WebContentFilter.VendorConfig`](/documentation/DeviceManagement/WebContentFilter/VendorConfig-data.dictionary) A custom dictionary for the filtering service plug-in. [`WebContentFilter.WhitelistedBookmarksItem`](/documentation/DeviceManagement/WebContentFilter/WhitelistedBookmarksItem) The bookmark in the allow list of the web content filter. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)