Skip to content

Transport Configuration

See the Options Reference for a description of each option.

Default Inclusion

Transport Rank Target Required Inclusion Features
alexa_devices FIRST always default MESSAGE, SPOKEN
alexa_media_player ANY always explicit MESSAGE, SPOKEN
chime ANY optional explicit SOUND
discord FIRST always default MESSAGE, TITLE, IMAGES, SNAPSHOT_IMAGE
email FIRST always default MESSAGE, TITLE, IMAGES, ACTIONS, TEMPLATE_FILE, SNAPSHOT_IMAGE
generic ANY optional explicit MESSAGE, TITLE
gotify ANY never explicit MESSAGE, TITLE, IMAGES, SNAPSHOT_IMAGE
html5 FIRST always default MESSAGE, TITLE, IMAGES, ACTIONS, SNAPSHOT_IMAGE
kodi ANY always explicit MESSAGE, TITLE, IMAGES, SNAPSHOT_IMAGE
lametric ANY never explicit MESSAGE, TITLE
matrix FIRST always default MESSAGE, TITLE, IMAGES, SNAPSHOT_IMAGE
media ANY always explicit IMAGES, VIDEO, SNAPSHOT_IMAGE, SOUND
mobile_push FIRST always default MESSAGE, TITLE, IMAGES, VIDEO, ACTIONS, SNAPSHOT_IMAGE
mqtt FIRST optional default MESSAGE
notify_entity LAST always default MESSAGE, TITLE
ntfy ANY never explicit MESSAGE, TITLE, IMAGES, ACTIONS, SNAPSHOT_IMAGE
persistent ANY never explicit MESSAGE, TITLE
pushover ANY never explicit MESSAGE, TITLE, IMAGES, SNAPSHOT_IMAGE
sms FIRST always default MESSAGE, TITLE
telegram FIRST always default MESSAGE, TITLE, IMAGES, ACTIONS, SNAPSHOT_IMAGE
tts ANY always explicit MESSAGE, SPOKEN

Target Categories

Which target categories each transport accepts - see Targets for how to qualify a target with one. Unique and Fallback categories also drive implicit selection (a default-inclusion delivery auto-fires once one of these is found in the notification's target or an available recipient's own capabilities) - Other categories are understood well enough to build a full envelope from once a delivery is selected by any other means, but are too ambiguous to drive selection on their own. A transport with none listed relies entirely on its own name, its deliveries' names, or a delivery's target_categories option (e.g. generic).

Transport Unique Fallback Other
alexa_devices entity_id (domain=notify, platform=alexa_devices), entity_id (domain=group) - -
alexa_media_player - - entity_id (domain=media_player, platform=alexa_media)
chime - - entity_id (domain=switch/script/group/rest_command/siren/media_player), device_id
discord discord_channel - -
email email - -
generic - - -
gotify - - -
html5 entity_id (domain=notify, platform=html5) - -
kodi - - entity_id (domain=media_player)
lametric - - -
matrix matrix_room - -
media - - entity_id (domain=media_player)
mobile_push mobile_app_id - -
mqtt topic - -
notify_entity - entity_id (domain=notify) -
ntfy - - -
persistent - - -
pushover - - -
sms phone - -
telegram telegram_chat_id - -
tts - - entity_id (domain=media_player), mobile_app_id

Default Options

Transport data_keys_select default_title device_discovery device_domain device_manufacturer_select device_model_select handle_as_domain jpeg_opts media_auto_pause message_usage mode png_opts preheader_blank preheader_length raw sender_name simplify_text strict_template strip_urls target_select tts_entity_id
alexa_devices N/A N/A N/A N/A N/A N/A N/A N/A N/A STANDARD N/A N/A N/A N/A N/A N/A True N/A True ['group\.[a-z0-9_]+', '^notify\.[A-Za-z0-9_]+$'] N/A
alexa_media_player N/A N/A N/A N/A N/A N/A N/A N/A True STANDARD N/A N/A N/A N/A N/A N/A True N/A True ['^media_player\.[A-Za-z0-9_]+$'] N/A
chime N/A N/A True ['alexa_devices'] N/A {'exclude': ['Speaker Group']} N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A ['(switch|script|group|rest_command|siren|media_player)\.[A-Za-z0-9_]+', '^[0-9a-f]{32}$'] N/A
discord N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A
email N/A Home Assistant Notification N/A N/A N/A N/A N/A {'progressive': 'true', 'optimize': 'true'} N/A STANDARD direct {'optimize': 'true'} ͏‌  100 N/A Home Assistant False False False N/A N/A
generic - N/A N/A N/A N/A N/A - N/A N/A STANDARD N/A N/A N/A N/A False N/A False N/A False N/A N/A
gotify N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A
html5 N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A ['^notify\.[A-Za-z0-9_]+$'] N/A
kodi N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A ['^media_player\.[A-Za-z0-9_]+$'] N/A
lametric N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A
matrix N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A
media N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A ['^media_player\.[A-Za-z0-9_]+$'] N/A
mobile_push - N/A False ['mobile_app'] N/A N/A N/A N/A N/A STANDARD N/A N/A N/A N/A N/A N/A False N/A False N/A N/A
mqtt N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A
notify_entity N/A N/A N/A N/A N/A N/A N/A N/A N/A STANDARD N/A N/A N/A N/A N/A N/A False N/A False ['^notify\.[A-Za-z0-9_]+$'] N/A
ntfy N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A
persistent N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A
pushover N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A
sms N/A N/A N/A N/A N/A N/A N/A N/A N/A COMBINE_TITLE N/A N/A N/A N/A N/A N/A True N/A False N/A N/A
telegram N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A
tts N/A N/A False ['mobile_app'] {'exclude': ['Apple']} N/A N/A N/A N/A STANDARD N/A N/A N/A N/A N/A N/A True N/A True ['^media_player\.[A-Za-z0-9_]+$', '(notify\.)?mobile_app_[a-z0-9_]+'] tts.home_assistant_cloud