# Notification

Action `bell`

`action.notification`

Display a native macOS notification banner with a customizable title, body, and optional click action URL. When the user clicks the notification, the action URL opens in the default handler (browser for HTTP links, Finder for file paths).

By default, notifications are forced to display even when Do Not Disturb is active. This can be toggled off for less critical alerts.

## Ports

Direction | Name | Data Type | Description
--- | --- | --- | ---
Input | Input | Any | Incoming payload for template interpolation

## Configuration

Field | Type | Default | Description
--- | --- | --- | ---
title | Text | — | Notification title. Supports `{{var}}` interpolation.
body | Text Area | — | Notification body text. Supports `{{var}}` interpolation.
actionURL | Text | — | URL or file path opened when notification is clicked. Supports `{{var}}`.
forceDisplay | Boolean | `true` | Always display even during Do Not Disturb.

## Output Variables

Variable | Type | Description
--- | --- | ---
notified | Boolean | Whether notification was sent
title | String | Resolved notification title
body | String | Resolved notification body

## Example

Alert when a watched file changes: