---
title: "insertOverlay(_:above:)"
framework: mapkit
role: symbol
role_heading: Instance Method
path: "mapkit/mkmapview/insertoverlay(_:above:)"
---

# insertOverlay(_:above:)

Inserts one overlay object above another.

## Declaration

```swift
func insertOverlay(_ overlay: any MKOverlay, above sibling: any MKOverlay)
```

## Parameters

- `overlay`: The overlay object to insert.
- `sibling`: An existing object in the doc://com.apple.mapkit/documentation/MapKit/MKMapView/overlays array. This object needs to exist in the array and can’t be nil.

## Discussion

Discussion This method inserts the overlay into the MKOverlayLevel.aboveLabels level and positions it relative to the specified sibling. When displaying it, the map view displays the overlay’s contents above that of its sibling. If the sibling isn’t in the same map level, this method appends the overlay to the end of the list of overlays at the indicated level.

## See Also

### Adding and inserting overlays

- [addOverlay(_:level:)](mapkit/mkmapview/addoverlay(_:level:).md)
- [addOverlays(_:level:)](mapkit/mkmapview/addoverlays(_:level:).md)
- [addOverlay(_:)](mapkit/mkmapview/addoverlay(_:).md)
- [addOverlays(_:)](mapkit/mkmapview/addoverlays(_:).md)
- [insertOverlay(_:at:level:)](mapkit/mkmapview/insertoverlay(_:at:level:).md)
- [insertOverlay(_:at:)](mapkit/mkmapview/insertoverlay(_:at:).md)
- [insertOverlay(_:below:)](mapkit/mkmapview/insertoverlay(_:below:).md)
- [exchangeOverlay(_:with:)](mapkit/mkmapview/exchangeoverlay(_:with:).md)
- [exchangeOverlay(at:withOverlayAt:)](mapkit/mkmapview/exchangeoverlay(at:withoverlayat:).md)