<!--
{
  "availability" : [
    "iOS: 11.0.0 -",
    "iPadOS: 11.0.0 -",
    "macCatalyst: 13.1.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 7.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "NetworkExtension",
  "identifier" : "/documentation/NetworkExtension/NEHotspotConfigurationManager",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Network Extension"
    ],
    "preciseIdentifier" : "c:objc(cs)NEHotspotConfigurationManager"
  },
  "title" : "NEHotspotConfigurationManager"
}
-->

# NEHotspotConfigurationManager

A manager that applies and removes hotspot configurations of Wi-Fi networks.

```
class NEHotspotConfigurationManager
```

## Overview

When your app creates a new hotspot configuration using [`NEHotspotConfiguration`](/documentation/NetworkExtension/NEHotspotConfiguration) and applies it to a Wi-Fi network or attempts to update a previously configured network, the device prompts the user for approval. Without explicit user consent, your app can’t make configuration changes.

Your app can use [`removeConfiguration(forHS20DomainName:)`](/documentation/NetworkExtension/NEHotspotConfigurationManager/removeConfiguration(forHS20DomainName:)) or [`removeConfiguration(forSSID:)`](/documentation/NetworkExtension/NEHotspotConfigurationManager/removeConfiguration(forSSID:)) to delete a configuration that it has added, but not a configuration added by another app or user. The user can also delete configured networks using Settings > Wi-Fi.

When your app is uninstalled, iOS removes the configurations of all networks your app has configured, including their keychain entries.

Hotspot Configuration Manager errors are listed in [`NEHotspotConfigurationError`](/documentation/NetworkExtension/NEHotspotConfigurationError).

> Important:
> To use the ``doc://com.apple.networkextension/documentation/NetworkExtension/NEHotspotConfigurationManager`` class, you must enable the Hotspot Configuration capability in Xcode. For more information, see <doc://com.apple.documentation/documentation/BundleResources/Entitlements/com.apple.developer.networking.HotspotConfiguration>.

## Topics

### Creating configurations

[`shared`](/documentation/NetworkExtension/NEHotspotConfigurationManager/shared)

Instantiates [`NEHotspotConfigurationManager`](/documentation/NetworkExtension/NEHotspotConfigurationManager) as a singleton, so it can be shared.

[`apply(_:completionHandler:)`](/documentation/NetworkExtension/NEHotspotConfigurationManager/apply(_:completionHandler:))

Adds or updates a Wi-Fi network configuration after prompting the user for permission, and then attempts to join the network under certain conditions.

### Getting a list of configurations

[`getConfiguredSSIDs(completionHandler:)`](/documentation/NetworkExtension/NEHotspotConfigurationManager/getConfiguredSSIDs(completionHandler:))

Submits a completion handler the configuration manager calls to send your app
the names of the SSIDs or Wi-Fi hotspot domains in the configuration.

### Removing configuration

[`removeConfiguration(forHS20DomainName:)`](/documentation/NetworkExtension/NEHotspotConfigurationManager/removeConfiguration(forHS20DomainName:))

Removes a Wi-Fi hotspot configuration, identified by a Hotspot 2.0 domain name, that your app previously added.

[`removeConfiguration(forSSID:)`](/documentation/NetworkExtension/NEHotspotConfigurationManager/removeConfiguration(forSSID:))

Removes a Wi-Fi configuration, identified by an SSID, that your app previously added.

### Errors

[`NEHotspotConfigurationErrorDomain`](/documentation/NetworkExtension/NEHotspotConfigurationErrorDomain)

The domain string for errors involving hotspot configuration.

[`NEHotspotConfigurationError`](/documentation/NetworkExtension/NEHotspotConfigurationError)

Error values returned by hotspot configuration manager methods.

### Entitlements

  <doc://com.apple.documentation/documentation/BundleResources/Entitlements/com.apple.developer.networking.HotspotConfiguration>


---

Copyright &copy; 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)