<!--
{
  "availability" : [
    "iOS: 13.0.0 - 27.0.0",
    "iPadOS: 13.0.0 - 27.0.0",
    "macCatalyst: 13.0.0 - 27.0.0",
    "tvOS: 13.0.0 - 27.0.0",
    "visionOS: 1.0.0 - 27.0.0",
    "watchOS: 6.0.0 - 27.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/ActionSheet",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI11ActionSheetV"
  },
  "title" : "ActionSheet"
}
-->

# ActionSheet

A representation of an action sheet presentation.

```
struct ActionSheet
```

## Overview

Use an action sheet when you want the user to make a choice between two
or more options, in response to their own action. If you want the user to
act in response to the state of the app or the system, rather than a user
action, use an [`Alert`](/documentation/SwiftUI/Alert) instead.

You show an action sheet by using the
[`actionSheet(isPresented:content:)`](/documentation/SwiftUI/View/actionSheet(isPresented:content:)) view modifier to create an
action sheet, which then appears whenever the bound `isPresented` value is
`true`. The `content` closure you provide to this modifier produces a
customized instance of the `ActionSheet` type. To supply the options, create
instances of [`ActionSheet.Button`](/documentation/SwiftUI/ActionSheet/Button) to distinguish between ordinary options,
destructive options, and cancellation of the user’s original action.

The action sheet handles its dismissal by setting the bound
`isPresented` value back to `false` when the user taps a button in the
action sheet.

The following example creates an action sheet with three options: a Cancel
button, a destructive button, and a default button. The second and third of
these call methods are named `overwriteWorkout` and `appendWorkout`,
respectively.

```
@State private var showActionSheet = false
var body: some View {
    Button("Tap to show action sheet") {
        showActionSheet = true
    }
    .actionSheet(isPresented: $showActionSheet) {
        ActionSheet(title: Text("Resume Workout Recording"),
                    message: Text("Choose a destination for workout data"),
                    buttons: [
                        .cancel(),
                        .destructive(
                            Text("Overwrite Current Workout"),
                            action: overwriteWorkout
                        ),
                        .default(
                            Text("Append to Current Workout"),
                            action: appendWorkout
                        )
                    ]
        )
    }
}
```

The system may interpret the order of items as they appear in the `buttons`
array to accommodate platform conventions. In this example, the Cancel
button is the first member of the array, but the action sheet puts it in its
standard position at the bottom of the sheet.

![An action sheet with the title Resume Workout Recording in bold text and the message Choose a destination for workout data in smaller text. Below the text, three buttons: a destructive Overwrite Current Workout button in red, a default-styled Overwrite Current Workout button, and a Cancel button, farther below and set off in its own button group.](images/com.apple.SwiftUI/SwiftUI-ActionSheet-cancel-and-destructive@2x.png)

## Topics

### Creating an action sheet

[`init(title:message:buttons:)`](/documentation/SwiftUI/ActionSheet/init(title:message:buttons:))

Creates an action sheet with the provided buttons.

### Specifying the button type

[`Button`](/documentation/SwiftUI/ActionSheet/Button)

A button representing an operation of an action sheet presentation.


---

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)