# TN3111: iOS Wi-Fi API overview Explore the various Wi-Fi APIs available on iOS and their expected use cases. ## Overview iOS does not have a general-purpose API for Wi-Fi scanning and configuration. However, it does support a wide range of special-purpose Wi-Fi APIs. This technote lists some use cases supported by those special-purpose APIs. While the focus of this technote is iOS, these APIs are also available on iPadOS. ## Navigate an internet hotspot If your app helps the user navigate an internet hotspot — a Wi-Fi network where the user must interact with the network to gain access to the wider internet — adopt the API. To use `NEHotspotHelper` you must first be granted a special entitlement (`com.apple.developer.networking.HotspotHelper`) by Apple. For information on how to apply for this, see . > Important: `NEHotspotHelper` is *only* useful for hotspot integration. There are both technical and business restrictions that prevent it from being used for other tasks, such as accessory integration or Wi-Fi based location. iOS 26 introduced support for hotspot helper app extensions. Adopt these to improve the efficiency, reliability, and privacy of your hotspot helper app. ## Add an accessory to the user’s network If you’re creating a hardware accessory and you want to make it easy for the user to add it to their local network, your best option is to build your accessory with that in mind. Use one of these approaches: - Wireless Accessory Configuration (WAC) — The user can configure a WAC-capable accessory directly in Settings. Optionally, use to integrate accessory configuration directly in your app. - HomeKit — Call `HMHome` APIs like to ask the system to scan for, pair, and configure any unpaired HomeKit accessories . > Important: To add WAC or HomeKit support to your accessory, join the [MFi Program](https://mfi.apple.com/). If your accessory does not support WAC or HomeKit, you can build an accessory configuration experience on top of `NEHotspotConfigurationManager`, although this will not be as seamless as the WAC and HomeKit accessory experience. For an example of how you might approach this, see . ## Temporarily join a network If your app needs to temporarily join a Wi-Fi network — for example, you want to interact with a Wi-Fi enabled accessory with its own independent network — use `NEHotspotConfigurationManager` and set to true. For more details, see . If you’re working with a Wi-Fi accessory, use to simplify discovery and configuration of your accessory. ## Permanently join a network Some apps need to configure the iOS device to permanently join a Wi-Fi network, as if the user had selected the network in Settings > Wi-Fi. For example, an app from an ISP might do this to get the user’s iOS device on to the Wi-Fi network published by a new DSL gateway that they’ve just installed. If your app needs to do this, use `NEHotspotConfigurationManager` and set to false. For more details, see . ## Peer-to-peer networking If your goal is to communicate with nearby devices and accessories without configuring a Wi-Fi network, you have two options: - Wi-Fi Aware™ (also known as Neighbor Awareness Networking or NAN) - Apple peer-to-peer Wi-Fi iOS introduced support for Wi-Fi Aware in iOS 26. It’s supported on iPhone 12 and later. See the framework documentation for more details. Wi-Fi Aware is an industry standard specification, opening up the possibility of communicating with non-Apple devices and accessories. Apple peer-to-peer Wi-Fi dates all the way back to iOS 7. It works on all iOS, iPadOS, macOS, tvOS, and visionOS devices. For information about networking APIs that support Apple peer-to-peer Wi-Fi, see . > Note: A common misconception is that Multipeer Connectivity is the only way to use Apple peer-to-peer Wi-Fi. That’s not the case. See [TN3151](doc://com.apple.documentation/documentation/Technotes/tn3151-choosing-the-right-networking-api) for the full story. Apple peer-to-peer Wi-Fi is not documented for third-party use, so this mechanism only works between Apple devices. ## Location tracking If you’d like to use Wi-Fi data to determine the device’s location, use Core Location. This locates the device using a wide variety of techniques, including Wi-Fi. For more information, see [Maps and Location](https://developer.apple.com/maps/). ## Current Wi-Fi network If you need to know the name of the device’s current Wi-Fi network, call . That method requires iOS 14 or later. On older systems, call . ## Revision History - **2025-08-29** Added information about hotspot helper app extensions and Wi-Fi Aware, both new in iOS 26. - **2024-09-24** Added information about AccessorySetupKit. Added a link to TN3151. Made other minor editorial changes. - **2022-05-24** Made minor editorial changes. - **2022-02-08** Republished as TN3111. Broke the content into task-focused sections. Added a link to . Added a reference to . Updated the text for the new publication platform. - **2017-08-14** Added information about `NEHotspotConfigurationManager`. - **2016-11-16** First published as QA1942 ”iOS Wi-Fi Management APIs”. --- 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)