---
title: showsSuppressionButton
framework: appkit
role: symbol
role_heading: Instance Property
path: appkit/nsalert/showssuppressionbutton
---

# showsSuppressionButton

Specifies whether the alert includes a suppression checkbox, which you can employ to allow a user to opt out of seeing the alert again.

## Declaration

```swift
var showsSuppressionButton: Bool { get set }
```

## Discussion

Discussion The default value of this property is false, which specifies the absence of a suppression checkbox in the alert. Set the value to true to show a suppression checkbox in the alert. By default, a suppression checkbox has the title, “Do not show this message again.” In macOS 11.0 and later, if the alert displays multiple buttons that prompt the user to make a choice, the title is “Do not ask again.” To customize it, use the checkbox’s title property, as follows: myAlert.suppressionButton.title = "Do not show this warning again" To create an alert that responds to the selection state of the suppression checkbox, use code like that shown in Listing 1 to produce the alert shown below. Listing 1. Creating an alert with a suppression checkbox let alertSuppressionKey = "AlertSuppression" let defaults = UserDefaults.standard

if defaults.bool(forKey: alertSuppressionKey) {     print("Alert suppressed") } else {     let anAlert = NSAlert()     anAlert.messageText = "Message text."     anAlert.informativeText = "Informative Text."     anAlert.showsSuppressionButton = true     anAlert.runModal()

if let suppressionButton = anAlert.suppressionButton,        suppressionButton.state == .on {         defaults.set(true, forKey: alertSuppressionKey)     } }

## See Also

### Displaying Alerts

- [runModal()](appkit/nsalert/runmodal().md)
- [beginSheetModal(for:completionHandler:)](appkit/nsalert/beginsheetmodal(for:completionhandler:).md)
- [beginSheetModal(for:modalDelegate:didEnd:contextInfo:)](appkit/nsalert/beginsheetmodal(for:modaldelegate:didend:contextinfo:).md)
- [suppressionButton](appkit/nsalert/suppressionbutton.md)