<!--
{
  "availability" : [
    "iOS: 11.0.0 -",
    "iPadOS: 11.0.0 -",
    "macCatalyst: 13.1.0 -",
    "tvOS: 11.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/UIViewPropertyAnimator/pausesOnCompletion",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "c:objc(cs)UIViewPropertyAnimator(py)pausesOnCompletion"
  },
  "title" : "pausesOnCompletion"
}
-->

# pausesOnCompletion

A Boolean value that indicates whether a completed animation remains in the active state.

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

## Discussion

When the value of this property is <doc://com.apple.documentation/documentation/Swift/true>, the animator remains in the [`UIViewAnimatingState.active`](/documentation/UIKit/UIViewAnimatingState/active) state when the animation finishes, and it does not execute its completion handler. Keeping the animator in the [`UIViewAnimatingState.active`](/documentation/UIKit/UIViewAnimatingState/active) state allows you to reverse the animation even after it has finished. When the value of this property is <doc://com.apple.documentation/documentation/Swift/false>, the animator automatically transitions to the [`UIViewAnimatingState.inactive`](/documentation/UIKit/UIViewAnimatingState/inactive) state when the animation finishes, thereby concluding the animation. The default value of this property is <doc://com.apple.documentation/documentation/Swift/false>.

Because the completion handler is not called when this property is <doc://com.apple.documentation/documentation/Swift/true>, you cannot use the animator’s completion handler to determine when the animations have finished running. Instead, you determine when the animation has ended by observing the [`isRunning`](/documentation/UIKit/UIViewAnimating/isRunning) property.

---

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)