<!--
{
  "availability" : [
    "iOS: 11.0.0 -",
    "iPadOS: 11.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "ARKit",
  "identifier" : "/documentation/ARKit/ARSession/run(_:options:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "ARKit"
    ],
    "preciseIdentifier" : "c:objc(cs)ARSession(im)runWithConfiguration:options:"
  },
  "title" : "run(_:options:)"
}
-->

# run(_:options:)

Starts AR processing for the session with the specified configuration and options.

```
func run(_ configuration: ARConfiguration, options: ARSession.RunOptions = [])
```

## Parameters

`configuration`

An object that defines motion and scene tracking behaviors for the session.

`options`

Options affecting how existing session state (if any) transitions to the new configuration.

    If the session is running for the first time, this parameter has no effect.

## Discussion

The session tracks device motion, captures and processes scene imagery from the device camera, and coordinates with your [`delegate`](/documentation/ARKit/ARSession/delegate) object or [`ARSCNView`](/documentation/ARKit/ARSCNView) or [`ARSKView`](/documentation/ARKit/ARSKView) view only when running.

Calling this method on a session that has already started transitions immediately to the new session configuration. The `options` parameter determines how existing session state transitions to the new configuration. By default, the session resumes device position tracking from the last known state and keeps any anchors already included in the session (those you’ve added manually with [`add(anchor:)`](/documentation/ARKit/ARSession/add(anchor:)), as well as those added automatically by ARKit features such as plane detection or face tracking).

This method returns immediately when called, but the session continues to run.

---

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)