<!--
{
  "availability" : [
    "iOS: 26.0.0 -",
    "iPadOS: 26.0.0 -",
    "macCatalyst: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CoreTelephony",
  "identifier" : "/documentation/CoreTelephony/CTCellularPlanProvisioning/update(_:completionHandler:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Core Telephony"
    ],
    "preciseIdentifier" : "c:objc(cs)CTCellularPlanProvisioning(im)updateCellularPlanProperties:completionHandler:"
  },
  "title" : "update(_:completionHandler:)"
}
-->

# update(_:completionHandler:)

Updates the capability and region availability for an eSIM.

```
func update(_ properties: CTCellularPlanProperties, completionHandler: @escaping @Sendable ((any Error)?) -> Void)
```

```
func update(_ properties: CTCellularPlanProperties) async throws
```

## Parameters

`properties`

A required parameter where you specify the eSIM’s [`associatedIccid`](/documentation/CoreTelephony/CTCellularPlanProperties/associatedIccid), [`simCapability`](/documentation/CoreTelephony/CTCellularPlanProperties/simCapability) and [`supportedRegionCodes`](/documentation/CoreTelephony/CTCellularPlanProperties/supportedRegionCodes-yhu5). If missing, an error is returned. You are allowed to provide an empty list for `supportedRegionCodes`.

`completionHandler`

A completion handler that executes after processing the request. The parameter passed to the completion handler indicates whether the request succeeded, failed, or ended in an unknown state.

## Overview

When you can’t call [`addPlan(request:properties:completionHandler:)`](/documentation/CoreTelephony/CTCellularPlanProvisioning/addPlan(request:properties:completionHandler:)) because a person installs your SIM with a QR Code, a universal link, or a physical SIM, use this method to issue eSIM property information for a particular eSIM before provisioning begins. Use the `associatedIccid` so that the system can match the future install with your provided property information.

You can also use this method to update information on an ICCID that already exists on the device. After matching the `associatedICCID`, the system updates the eSIM with the information you provide.

---

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)