---
title: NetworkRelay
framework: Device Management
role: symbol
role_heading: Object
platforms: [iOS 27.0+, iPadOS 27.0+, Mac Catalyst 27.0+, macOS 27.0+, visionOS 27.0+]
path: devicemanagement/networkrelay
---

# NetworkRelay

The declaration to configure Network Relay settings.

## Declaration

```data
object NetworkRelay
```

## Properties

AllowDNSFailover: If true, the device allows the relay to failover to the default system DNS resolver. ExcludedDomains: A list of domain strings to exclude from routing through the servers in Relays. Any connection that matches a domain in the list exactly or is a subdomain of the listed domain won’t use the relay server. ExcludedFQDNs: A list of Fully Qualified Domain Names (FQDNs) to exclude from routing through the servers contained in Relays. Any connection that matches an FQDN in the list exactly won’t use the relay server. When MatchDomains is also present, any FQDN listed in the list should be a subdomain of at least one MatchDomain value, otherwise it won’t have any effect. MatchDomains: A list of domain strings that the system uses to determine which connection to route through the servers in Relays. Any connection that matches a domain in the list exactly or is a subdomain of the listed domain uses the relay servers, unless it matches a domain in ExcludedDomains. If this list and MatchFQDNs are empty, the system routes traffic to all domains to the relay servers, except those that match an excluded domain or excluded FQDN. MatchFQDNs: A list of Fully Qualified Domain Names (FQDNs) to route through the servers contained in Relays. Any connection that matches an FQDN in the list exactly uses the relay servers. If this list and MatchDomains are empty, the system routes traffic to all domains to the relay servers, except those that match an excluded domain or excluded FQDN. Relays: An array of dictionaries that describe one or more relay servers that the system can chain together. RelayUUID: A globally unique identifier for this relay configuration. The system uses this UUID to route managed apps through the servers in Relays. This key is required for user enrollment. Available: iOS 27+ | iPadOS 27+ | visionOS 27+ UIToggleEnabled: If true, the device allows the user to disable this network relay configuration. VisibleName: The name of the network relays that the system displays on the device.

## Discussion

Discussion Specify com.apple.configuration.network.relay as the declaration type. Configuration availability  |   |   |   |   |   |   |   |  Configuration examples

## Topics

### Objects

- [NetworkRelayRelayObject](devicemanagement/networkrelayrelayobject.md)

## See Also

### Configurations

- [AccessibilitySettings](devicemanagement/accessibilitysettings.md)
- [AccountCalDAV](devicemanagement/accountcaldav.md)
- [AccountCardDAV](devicemanagement/accountcarddav.md)
- [AccountExchange](devicemanagement/accountexchange.md)
- [AccountGoogle](devicemanagement/accountgoogle.md)
- [AccountLDAP](devicemanagement/accountldap.md)
- [AccountMail](devicemanagement/accountmail.md)
- [AccountSettings](devicemanagement/accountsettings.md)
- [AccountSubscribedCalendar](devicemanagement/accountsubscribedcalendar.md)
- [AppManaged](devicemanagement/appmanaged.md)
- [AppSettings](devicemanagement/appsettings.md)
- [AudioAccessorySettings](devicemanagement/audioaccessorysettings.md)
- [ContentCaching](devicemanagement/contentcaching.md)
- [DiskManagementSettings](devicemanagement/diskmanagementsettings.md)
- [ExtensibleSSO](devicemanagement/extensiblesso.md)