<!--
{
  "availability" : [
    "iOS: 4.0.0 -",
    "iPadOS: 4.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.9.0 -",
    "tvOS: 9.2.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "MapKit",
  "identifier" : "/documentation/MapKit/MKMapView/insertOverlay(_:at:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "MapKit"
    ],
    "preciseIdentifier" : "c:objc(cs)MKMapView(im)insertOverlay:atIndex:"
  },
  "title" : "insertOverlay(_:at:)"
}
-->

# insertOverlay(_:at:)

Inserts an overlay object into the list associated with the map.

```
func insertOverlay(_ overlay: any MKOverlay, at index: Int)
```

## Parameters

`overlay`

The overlay object to insert.

`index`

The index at which to insert the overlay object. If this value is greater than the number of objects in the [`overlays`](/documentation/MapKit/MKMapView/overlays) property, this method appends the object to the end of the array.

## Discussion

This method inserts the overlay into the [`MKOverlayLevel.aboveLabels`](/documentation/MapKit/MKOverlayLevel/aboveLabels) level.

---

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)