<!--
{
  "documentType" : "article",
  "framework" : "watchOS Apps",
  "identifier" : "/documentation/watchOS-Apps/presenting-notifications-on-apple-watch",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Presenting notifications on Apple Watch"
}
-->

# Presenting notifications on Apple Watch

Understand how the system displays incoming notifications.

## Overview

When the Apple Watch displays a notification, the system first presents the short-look
interface. If the user continues to look at the notification, the system transitions
quickly from the short-look interface to the long-look interface

### Display a short-look interface

The *short-look* interface is a nonscrolling screen that the system creates automatically.

![A screenshot of the short-look interface, with the icon, title, and app name called out.](images/com.apple.watchOS-Apps/presenting-notifications-on-apple-watch-1@2x.png)

The system uses a template to display the app name and icon along with the title
string from the notification payload, and you can’t customize this interface. For
local notifications, you specify the title string using the <doc://com.apple.documentation/documentation/UserNotifications/UNMutableNotificationContent>
object’s <doc://com.apple.documentation/documentation/UserNotifications/UNMutableNotificationContent/title>
property. For remote notifications, you specify it using the `alert` dictionary’s
`title` key inside the notification’s payload.

### Transition to the long-look interface

The *long-look* interface is a scrollable screen that displays the notification’s content
and any associated action buttons. The system’s default long-look interface includes
your app icon, the notification’s title string, and the alert message; however, your
app can customize this interface.

![A screenshot of the short-look interface, with the sash, content, actions, and dismiss button called out.](images/com.apple.watchOS-Apps/presenting-notifications-on-apple-watch-2@2x.png)

The long-look notification includes the following sections:

- The sash is an overlay that contains the app icon and app name. The system automatically
  generates the sash, but you can configure the appearance using the hosting controller’s
  <doc://com.apple.documentation/documentation/SwiftUI/WKUserNotificationHostingController/sashColor>,
  <doc://com.apple.documentation/documentation/SwiftUI/WKUserNotificationHostingController/titleColor>,
  <doc://com.apple.documentation/documentation/SwiftUI/WKUserNotificationHostingController/subtitleColor>,
  and <doc://com.apple.documentation/documentation/SwiftUI/WKUserNotificationHostingController/wantsSashBlur>
  properties.
- The content area contains detailed information about the incoming notification.
  If you provide a dynamic interactive interface for the notification, the content
  area can contain controls, like buttons or switches. For information on customizing
  the long-look interface, see [Customizing your long-look interface](/documentation/watchOS-Apps/customizing-your-long-look-interface).
- The bottom contains a Dismiss button and any registered action buttons. For more
  information, see [Adding actions to notifications on watchOS](/documentation/watchOS-Apps/adding-actions-to-notifications-on-watchos).

By default, the system dismisses the long-look interface, launches your app, and
calls your notification center delegate’s <doc://com.apple.documentation/documentation/UserNotifications/UNUserNotificationCenterDelegate/userNotificationCenter(_:didReceive:withCompletionHandler:)>
method when the user taps the notification. The response parameter’s <doc://com.apple.documentation/documentation/UserNotifications/UNNotificationResponse/actionIdentifier>
property varies, as shown below.

|Interface element|Action identifier                                                                                    |
|-----------------|-----------------------------------------------------------------------------------------------------|
|Action button    |The identifier for the selected action                                                               |
|Dismiss button   |<doc://com.apple.documentation/documentation/UserNotifications/UNNotificationDismissActionIdentifier>|
|Anywhere else    |<doc://com.apple.documentation/documentation/UserNotifications/UNNotificationDefaultActionIdentifier>|

For dynamic interactive interfaces, tapping the app content doesn’t launch your watchOS
app. Instead, the user can interact with any controls placed in the interface, and
the system calls the corresponding action method. The system only dismisses the
notification and launches your app if the user taps the app icon or sash, or if you
explicitly call the notification controller’s <doc://com.apple.documentation/documentation/WatchKit/WKUserNotificationInterfaceController/performNotificationDefaultAction()>
method.

---

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)