---
title: CellularPrivateNetwork
framework: devicemanagement
role: symbol
role_heading: Device Management Profile
path: devicemanagement/cellularprivatenetwork
---

# CellularPrivateNetwork

The payload that provides device info on private network deployments, including geographical location, preference over Wi-Fi, and network deployment type.

## Declaration

```data
object CellularPrivateNetwork
```

## Properties

CellularDataPreferred: Set to true to prefer this private network over Wi-Fi. CsgNetworkIdentifier: A string using the 3GPP “CSG_ID” format (defined in 3GPP 23.003, Section 4.7). The device uses this value to match a SIM present on the device. All combinations of NetworkIdentifier and CsgNetworkIdentifier must be unique across all profiles installed on the device. Available: iOS 18+ | iPadOS 18+ DataSetName: The name of the private network configuration data set. EnableNRStandalone: Set to true if this private network is NR Standalone. Geofences: A list of up to 1000 geofences for private networks. Geofencing is only used on iPhone. NetworkIdentifier: A string using the 3GPP “Coordinated NID” (option 1 or option 2) format (defined in 3GPP 31.102, Section 12.7.1). The device uses this value to match a SIM present on the device. All combinations of NetworkIdentifier and CsgNetworkIdentifier must be unique across all profiles installed on the device. Available: iOS 18+ | iPadOS 18+ VersionNumber: The version number of this dataset that the system uses to track updates.

## Discussion

Discussion Specify com.apple.cellularprivatenetwork.managed as the payload type. Profile availability  |   |   |   |   |   |   |   |  Profile example <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> 	<key>PayloadContent</key> 	<array> 		<dict> 			<key>CellularDataPreferred</key> 			<true/> 			<key>DataSetName</key> 			<string>ExamplePrivateNetwork</string> 			<key>EnableNRStandalone</key> 			<true/> 			<key>Geofences</key> 			<array> 				<dict> 					<key>Longitude</key> 					<real>-122.009</real> 					<key>Latitude</key> 					<real>37.3346</real> 					<key>Radius</key> 					<real>200</real> 					<key>GeofenceId</key> 					<string>AppleParkGeofence</string> 				</dict> 			</array> 			<key>VersionNumber</key> 			<string>1.0</string> 			<key>PayloadIdentifier</key> 			<string>com.example.cellularprivatenetwork</string> 			<key>PayloadDescription</key> 			<string>GeofenceData</string> 			<key>PayloadType</key> 			<string>com.apple.cellularprivatenetwork.managed</string> 			<key>PayloadUUID</key> 			<string>1d6d6912-708e-441a-9272-526ef05bbe3c</string> 			<key>PayloadVersion</key> 			<integer>1</integer> 		</dict> 	</array> 	<key>PayloadDisplayName</key> 	<string>Cellular Private Network</string> 	<key>PayloadIdentifier</key> 	<string>com.example.myprofile</string> 	<key>PayloadType</key> 	<string>Configuration</string> 	<key>PayloadUUID</key> 	<string>3425E7C2-9B02-49EB-8818-F65AA36DDE83</string> 	<key>PayloadVersion</key> 	<integer>1</integer> </dict> </plist>

## Topics

### Objects

- [CellularPrivateNetwork.GeofenceItem](devicemanagement/cellularprivatenetwork/geofenceitem.md)

## See Also

### Networking

- [Cellular](devicemanagement/cellular.md)
- [ContentCachingService](devicemanagement/contentcachingservice.md)
- [DNSSettings](devicemanagement/dnssettings.md)
- [Domains](devicemanagement/domains.md)
- [Firewall](devicemanagement/firewall.md)
- [NetworkUsageRules](devicemanagement/networkusagerules.md)
- [Relay](devicemanagement/relay.md)
- [WiFi](devicemanagement/wifi.md)
- [WiFiManagedSettings](devicemanagement/wifimanagedsettings.md)