Skip to content

LocationDevice & system

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
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

What 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

SourcePathNotes
Full file system/private/var/preferences/com.apple.wifi.known-networks.plistBinary plist, iOS 14+
Full file system/private/var/preferences/com.apple.wifi-private-mac-networks.plistPrivate (randomised) address per network
Older layout/private/var/preferences/SystemConfiguration/com.apple.wifi.plistPre-iOS 14, may survive upgrades
Encrypted backupSystemPreferencesDomainResolve 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):

KeyMeaning
SSID / dictionary key wifi.network.ssid.<name>Network name
SupportedSecurityTypesSecurity type
AddedAtWhen the network was added
JoinedByUserAtLast manual join
JoinedBySystemAtLast automatic join
UpdatedAtLast update of the entry
BSSList / __OSSpecific__BSSIDs, channels and per-BSS dates
Hidden and private address keysHidden network flag and private Wi-Fi address settings (key names vary by release)
AddReasonHow 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) from JoinedBySystemAt (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.

See also