<!--
{
  "availability" : [
    "iOS: 9.0.0 -",
    "iPadOS: 9.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.15.0 -",
    "watchOS: 4.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CoreLocation",
  "identifier" : "/documentation/CoreLocation/CLLocationManager/allowsBackgroundLocationUpdates",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "Core Location"
    ],
    "preciseIdentifier" : "c:objc(cs)CLLocationManager(py)allowsBackgroundLocationUpdates"
  },
  "title" : "allowsBackgroundLocationUpdates"
}
-->

# allowsBackgroundLocationUpdates

A Boolean value that indicates whether the app receives location updates when running in the background.

```
var allowsBackgroundLocationUpdates: Bool { get set }
```

## Discussion

Apps that receive location updates when running in the background must include the <doc://com.apple.documentation/documentation/BundleResources/Information-Property-List/UIBackgroundModes> key (with the `location` value) in their app’s `Info.plist` file. After including the <doc://com.apple.documentation/documentation/BundleResources/Information-Property-List/UIBackgroundModes> key, set the value of [`allowsBackgroundLocationUpdates`](/documentation/CoreLocation/CLLocationManager/allowsBackgroundLocationUpdates) to <doc://com.apple.documentation/documentation/Swift/true>. Use this property to enable and disable background updates programmatically. For example, you might set this property to <doc://com.apple.documentation/documentation/Swift/true> only after the user enables features in your app that require background location updates.

When the value of this property is <doc://com.apple.documentation/documentation/Swift/true> and you start location updates while the app is in the foreground, Core Location configures the system to keep the app running to receive continuous background location updates, and arranges to show the background location indicator (blue bar or pill) if needed. Updates continue even if the app subsequently enters the background.

When the value of this property is <doc://com.apple.documentation/documentation/Swift/false>, location updates may or may not continue in the background depending on other factors, including other background modes. In this configuration Core Location doesn’t configure the system to keep the app running for delivery, or display the background location indicator to extend the effectiveness of the [`CLAuthorizationStatus.authorizedWhenInUse`](/documentation/CoreLocation/CLAuthorizationStatus/authorizedWhenInUse) authorization while the app is running in the background.

The default value of this property is <doc://com.apple.documentation/documentation/Swift/false>.

> Important:
> Setting the value to <doc://com.apple.documentation/documentation/Swift/true> but omitting the `UIBackgroundModes` key and `location` value in your app’s `Info.plist` file is a fatal error that terminates the app.

---

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)