<!--
{
  "availability" : [
    "iOS: 7.0.0 -",
    "iPadOS: 7.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:level:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "MapKit"
    ],
    "preciseIdentifier" : "c:objc(cs)MKMapView(im)insertOverlay:atIndex:level:"
  },
  "title" : "insertOverlay(_:at:level:)"
}
-->

# insertOverlay(_:at:level:)

Inserts an overlay object into the level at the specified index.

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

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

`level`

The map level at which to place the overlay. For a list of possible values for this parameter, see [`MKOverlayLevel`](/documentation/MapKit/MKOverlayLevel).

## Discussion

Inserting an overlay at a specific level places that overlay’s visual representation in front of or behind other map content such as map labels and point-of-interest icons.

---

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)