Wi-Fi Known Networks on iOS
iOS known Wi-Fi networks in com.apple.wifi.known-networks.plist: SSIDs, BSSIDs, added and joined dates, and how they place a device.
- Location
- /private/var/preferences/com.apple.wifi.known-networks.plist (older releases: /private/var/preferences/SystemConfiguration/com.apple.wifi.plist); also com.apple.wifi-private-mac-networks.plist
- Evidence area
- Proves
- Which Wi-Fi networks the device knew, when each was added, last joined by the user or automatically, the BSSIDs seen, and settings such as private address and hidden networks
- Timestamps
- Property list dates (NSDate, stored as Cocoa time, shown as UTC)
- Acquisition
- Encrypted backup (Apple lists Wi-Fi settings among data only encrypted backups include) or full file system extraction
- Retention
- A network stays until the user forgets it or resets network settings; per-network dates are overwritten on each join. iCloud Keychain can sync networks from the owner's other devices
- Collection
- idevicebackup2 (encrypted), Full file system extraction
Tools
Compare all toolsWhat it is
Since iOS 14, the list of Wi-Fi networks an iPhone remembers is stored in a binary property list, com.apple.wifi.known-networks.plist. Each network is a dictionary keyed by its SSID, holding the security type, dates of addition and joins, the BSSIDs (access point MAC addresses) the device associated with, and flags such as hidden network or private Wi-Fi address. Before iOS 14 the same information lived in com.apple.wifi.plist, which some upgraded devices still carry.
For an investigator, known networks are a coarse but durable location source. A home, workplace, hotel or airport network with a join date can place the device in a place and time, and a BSSID can be geolocated through public wardriving databases, with caution.
Where it lives
| Source | Path | Notes |
|---|---|---|
| Full file system | /private/var/preferences/com.apple.wifi.known-networks.plist | Binary plist, iOS 14+ |
| Full file system | /private/var/preferences/com.apple.wifi-private-mac-networks.plist | Private (randomised) address per network |
| Older layout | /private/var/preferences/SystemConfiguration/com.apple.wifi.plist | Pre-iOS 14, may survive upgrades |
| Encrypted backup | SystemPreferencesDomain | Resolve the exact relative path in Manifest.db |
Apple states that Wi-Fi settings are only included in encrypted backups. An unencrypted backup will not have them.
What it proves
- The device knew a network with a given SSID and security type.
- When it was added and when it was last joined, by the user or automatically by the system.
- BSSIDs of access points it associated with, which identify the physical hardware.
- Whether the network was hidden, whether a private address was used, and captive portal details.
It does not prove continuous presence, and networks synced through iCloud Keychain from the owner's Mac or iPad may never have been joined by this iPhone.
Key fields
Keys observed in published parsers (the structure varies, so dump the plist and check):
| Key | Meaning |
|---|---|
SSID / dictionary key wifi.network.ssid.<name> | Network name |
SupportedSecurityTypes | Security type |
AddedAt | When the network was added |
JoinedByUserAt | Last manual join |
JoinedBySystemAt | Last automatic join |
UpdatedAt | Last update of the entry |
BSSList / __OSSpecific__ | BSSIDs, channels and per-BSS dates |
Hidden and private address keys | Hidden network flag and private Wi-Fi address settings (key names vary by release) |
AddReason | How the network was added (user, sync, profile...) where present |
Timestamps
Plist date values are stored as Cocoa time and shown in UTC by plutil and most parsers.
plutil -convert xml1 -o - com.apple.wifi.known-networks.plist | less
plutil -p com.apple.wifi.known-networks.plist | grep -E 'SSID|JoinedBy|AddedAt'
Each join overwrites the previous date. You get the last manual and last automatic join, not a history.
Retention
Entries persist until the user forgets the network, resets network settings, or erases the device. Dates change on every join. For join history, turn to Biome Wi-Fi streams, knowledgeC Wi-Fi connection events or unified logs, where available.
Collection
- Take an encrypted backup, or a full file system extraction.
- Collect both the known-networks plist and the private MAC plist, plus any legacy
com.apple.wifi.plist. - Hash the files before conversion; convert copies only.
Parsing
- iLEAPP parses the current and legacy plists, time fields and private MAC data.
plutil(macOS) converts and prints the plist for manual review.- Commercial suites list known networks in their device or location views.
Investigator tips
- Geolocating a BSSID through a public database such as WiGLE gives the location where the access point was observed by others, possibly years ago. Treat it as a lead and corroborate.
- Distinguish
JoinedByUserAt(someone chose the network) fromJoinedBySystemAt(automatic reconnection). - Check whether the network came from iCloud Keychain sync before placing the iPhone there.
- Combine with Significant Locations, locationd data and photo GPS in Photos.sqlite, as shown in the location guide.