<!--
{
  "availability" : [
    "MapKit JS: 5.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "MapKitJS",
  "identifier" : "/documentation/MapKitJS/Map/userLocationAnnotation",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "MapKit JS"
    ],
    "preciseIdentifier" : "instp/mapkit.Map/userLocationAnnotation"
  },
  "title" : "userLocationAnnotation"
}
-->

# userLocationAnnotation

An annotation that indicates the user’s location on the map.

```
get userLocationAnnotation(): UserLocationAnnotation | null;
```

## Discussion

This is the annotation, or blue dot, that indicates the user’s location on the map. This property is `null` if:

- [`showsUserLocation`](/documentation/MapKitJS/Map/showsUserLocation) is `false`.
- MapKit JS is trying to acquire the user’s location.
- MapKit JS fails to acquire the user’s location.

The map’s [`annotations`](/documentation/MapKitJS/Map/annotations) property only holds annotations you can modify. MapKit JS doesn’t add the [`userLocationAnnotation`](/documentation/MapKitJS/Map/userLocationAnnotation) property to the annotations array, and you can’t remove it by using [`removeAnnotation(annotation)`](/documentation/MapKitJS/Map/removeAnnotation). Use [`selectedAnnotation`](/documentation/MapKitJS/Map/selectedAnnotation) to reference the user’s location annotation when it’s in a selected state.

The default value of the [`collisionMode`](/documentation/MapKitJS/Annotation/collisionMode-data.property) property on the user’s location annotation is [`None`](/documentation/MapKitJS/AnnotationCollisionMode/None). The user’s location annotation doesn’t collide with other annotations unless you set the collision mode property to a value other than [`None`](/documentation/MapKitJS/AnnotationCollisionMode/None).

---

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)