<!--
{
  "availability" : [
    "iOS: 26.0.0 -",
    "iPadOS: 26.0.0 -",
    "macCatalyst: 26.0.0 -",
    "macOS: 26.0.0 -",
    "tvOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AVFoundation",
  "identifier" : "/documentation/AVFoundation/AVCaptureVideoPreviewLayer/isDeferredStartEnabled",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "AVFoundation"
    ],
    "preciseIdentifier" : "c:objc(cs)AVCaptureVideoPreviewLayer(py)deferredStartEnabled"
  },
  "title" : "isDeferredStartEnabled"
}
-->

# isDeferredStartEnabled

A `BOOL` value that indicates whether to defer starting this preview layer.

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

## Discussion

When this value is `true`, the session does not prepare the output’s resources until some time after [`startRunning()`](/documentation/AVFoundation/AVCaptureSession/startRunning()) returns. You can start the visual parts of your user interface (e.g. preview) prior to other parts (e.g. photo/movie capture, metadata output, etc..) to improve startup performance. Set this value to `false` if your app needs video preview immediately for startup, and `true` if it does not.

By default, this value is `false` for [`AVCaptureVideoPreviewLayer`](/documentation/AVFoundation/AVCaptureVideoPreviewLayer) objects, since this object is used to display preview. For best session start performance, set [`isDeferredStartEnabled`](/documentation/AVFoundation/AVCaptureVideoPreviewLayer/isDeferredStartEnabled) to `false` for preview layers. If your app contains multiple preview layers, you may want to display the main preview layer as soon as possible and allow the remaining layers to display subsequently. In this case, set [`isDeferredStartEnabled`](/documentation/AVFoundation/AVCaptureVideoPreviewLayer/isDeferredStartEnabled) to `true` for the remaining layers.

> Note: Setting this property to the same value for all outputs, including ``doc://com.apple.avfoundation/documentation/AVFoundation/AVCaptureVideoPreviewLayer`` and ``doc://com.apple.avfoundation/documentation/AVFoundation/AVCaptureOutput``, is equivalent to not using deferred start.

If [`isDeferredStartSupported`](/documentation/AVFoundation/AVCaptureVideoPreviewLayer/isDeferredStartSupported) is `false`, setting this property value to `true` results in the session throwing an `NSInvalidArgumentException`.

> Note: Set this value before calling ``doc://com.apple.avfoundation/documentation/AVFoundation/AVCaptureSession/commitConfiguration()`` as it requires a lengthy reconfiguration of the capture render pipeline.

---

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)