<!--
{
  "availability" : [
    "iOS: 11.3.0 -",
    "iPadOS: 11.3.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "ARKit",
  "identifier" : "/documentation/ARKit/ARCamera/TrackingState-swift.enum/Reason/relocalizing",
  "metadataVersion" : "0.1.0",
  "role" : "Case",
  "symbol" : {
    "kind" : "Case",
    "modules" : [
      "ARKit"
    ],
    "preciseIdentifier" : "s:So8ARCameraC5ARKitE13TrackingStateO6ReasonO12relocalizingyA2GmF"
  },
  "title" : "ARCamera.TrackingState.Reason.relocalizing"
}
-->

# ARCamera.TrackingState.Reason.relocalizing

The AR session is attempting to resume after an interruption.

```
case relocalizing
```

## Discussion

ARKit cannot track device position or orientation when the session has been interrupted (for example, by dismissing the view hosting an AR session or switching to another app). When resuming the session after an interruption, the world coordinate system (used for placing anchors) likely no longer match the device’s real-world environment.

If your session or view delegate implements the [`sessionShouldAttemptRelocalization(_:)`](/documentation/ARKit/ARSessionObserver/sessionShouldAttemptRelocalization(_:)) method and returns <doc://com.apple.documentation/documentation/Swift/true>, ARKit attempts to reconcile pre- and post-interruption world tracking state. During this process, called *relocalization*, world tracking quality is [`ARCamera.TrackingState.limited(_:)`](/documentation/ARKit/ARCamera/TrackingState-swift.enum/limited(_:)), with a resaon value of [`ARCamera.TrackingState.Reason.relocalizing`](/documentation/ARKit/ARCamera/TrackingState-swift.enum/Reason/relocalizing), indicating that hit tests and anchor placement are less accurate.

If successful, relocalization ends after a short time, tracking quality returns to the [`ARCamera.TrackingState.normal`](/documentation/ARKit/ARCamera/TrackingState-swift.enum/normal) state, and the world coordinate system and anchor positions reflect their state before the interruption.

For relocalization to succeed, the device must be returned to a position and orientation approximately near where it was when the session was interrupted. If these conditions never occur (or cannot occur; for example, if the device has moved to an entirely different environment), the session will remain in the [`ARCamera.TrackingState.Reason.relocalizing`](/documentation/ARKit/ARCamera/TrackingState-swift.enum/Reason/relocalizing) state indefinitely.

> Important:
> When in the ``doc://com.apple.arkit/documentation/ARKit/ARCamera/TrackingState-swift.enum/Reason/relocalizing`` state, offer the user a way out in case relocalization never succeeds. For example, offer a button for resetting the session, which appears after the relocalizing state has remained for a fixed amount of time.

---

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)