home-assistant.io/source/_integrations/persistent_notification.markdown

title	description	ha_category	ha_iot_class	ha_release	ha_quality_scale	ha_codeowners	ha_domain	ha_integration_type
Persistent Notification	Instructions on how to integrate persistent notifications into Home Assistant.	Other	Local Push	0.23	internal	@home-assistant/core	persistent_notification	system

The persistent_notification integration can be used to show a notification on the frontend that has to be dismissed by the user.

Service

The service persistent_notification.create takes in message, title, and notification_id.

Service data attribute	Optional	Description
message	no	Body of the notification. Accepts templates.
title	yes	Title of the notification. Accepts templates.
notification_id	yes	If notification_id is given, it will overwrite the notification if there already was a notification with that ID.

Here is how an action of your automation setup with static content could look like.

action:
  service: persistent_notification.create
  data:
    message: "Your message goes here"
    title: "Custom subject"

If you want to show some runtime information, you have to use templates.

{% raw %}

action:
  service: persistent_notification.create
  data:
    title: >
      Thermostat is {{ state_attr('climate.thermostat', 'hvac_action') }}
    message: "Temperature {{ state_attr('climate.thermostat', 'current_temperature') }}"

{% endraw %}

The service persistent_notification.dismiss requires a notification_id.

Service data attribute	Optional	Description
notification_id	no	the notification_id is required to identify the notification that should be removed.

This service allows you to remove a notifications by script or automation.

action:
  service: persistent_notification.dismiss
  data:
    notification_id: "1234"

Markdown support

The message attribute supports the Markdown formatting syntax. Some examples are:

Type	Message
Headline 1	# Headline
Headline 2	## Headline
Newline	\n
Bold	**My bold text**
Cursive	*My cursive text*
Link	[Link](https://home-assistant.io/)
Image	

/local/ in this context refers to the .homeassistant/www/ folder.

Create a persistent notification

Choose the Services tab from the Developer Tools sidebar item, then select the persistent_notification.create service from the "Service" dropdown. Enter something like the sample below into the Service Data field and press the CALL SERVICE button.

{
  "notification_id": "1234",
  "title": "Sample notification",
  "message": "This is a sample text"
}

This will create the notification entry shown above.