Skip to content

fix: Update Home Assistant notification help text for HA 2024 Services→Actions rename#7128

Merged
CommanderStorm merged 11 commits intomasterfrom
copilot/update-home-assistant-notification-text
Mar 10, 2026
Merged

fix: Update Home Assistant notification help text for HA 2024 Services→Actions rename#7128
CommanderStorm merged 11 commits intomasterfrom
copilot/update-home-assistant-notification-text

Conversation

Copy link
Contributor

Copilot AI commented Mar 10, 2026

Home Assistant renamed "Services" to "Actions" in 2024, making the notification configuration help text outdated and confusing.

Changes

  • Field label: Notification ServiceNotification Action
  • Help text: Updated Developer Tools > ServicesDeveloper Tools > Actions; added guidance that only the suffix after notify. should be entered (e.g. enter mobile_app_xyz, not notify.mobile_app_xyz); clarified that built-in mobile notifications require the action named "Send a notification via mobile_app_xyz", not "Send a notification" (which routes through external providers like Signal/Discord)
  • Automation trigger example: call_servicecall_action
  • YAML snippet: service:action:, service_data:data:
# Before
domain: notify
service: mobile_app_my_phone
service_data:
  title: Uptime Kuma

# After
domain: notify
action: mobile_app_my_phone
data:
  title: Uptime Kuma
Original prompt

This section details on the original issue you should resolve

<issue_title>Update Home Assistant notification help text</issue_title>
<issue_description>### 📑 I have found these related issues/pull requests

#1342 <-- This one can maybe be closed by the way?

🛡️ Security Policy

📝 Description

The Home Assistant notification copy is a bit out of date since HA renamed "Services" to "Actions":

Image
A list of Notification Services can be found in Home Assistant under "Developer Tools > Services" search for "notification" to find your device/phone name.

It should read "Developer Tools > Actions" instead. The name of this field should probably be "Notification Action"

It could probably be good to also update this to be a bit more clear, it was confusing for me. Namely, make it more clear that the notify is omitted from the HA action name. Also note that for a built-in HA notification, you need the action noted "Send a notification via mobile_app_xyz" and NOT "Send a notification". The latter is for external notifications (Signal, Discord, etc), which a kuma user probably doesn't want to use through HA


NOTES
This MR was written entirely by a human by the way
Thanks for the project, it's invaluable to me as a user!

👟 Reproduction steps

  1. Navigate to /settings/notifications
  2. Click "Set Up"
  3. Select the notification type "Home Assistant"
  4. View the description under "Notification Service"

👀 Expected behavior

In-app documentation to match current HA terminology

😓 Actual Behavior

In-app documentation is out of date

🐻 Uptime-Kuma Version

2.2.0

💻 Operating System and Arch

n/a

🌐 Browser

n/a

🖥️ Deployment Environment

Home Assistant Core 2026.3.1

📝 Relevant log output

```</issue_description>

## Comments on the Issue (you are @copilot in this section)

<comments>
</comments>

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

…inology

Co-authored-by: CommanderStorm <26258709+CommanderStorm@users.noreply.github.com>
Copilot AI changed the title [WIP] Update Home Assistant notification help text Update Home Assistant notification help text for HA 2024 Services→Actions rename Mar 10, 2026
src/lang/en.json Outdated
"Notification Action": "Notification Action",
"default: notify all devices": "default: notify all devices",
"A list of Notification Services can be found in Home Assistant under \"Developer Tools > Services\" search for \"notification\" to find your device/phone name.": "A list of Notification Services can be found in Home Assistant under \"Developer Tools > Services\" search for \"notification\" to find your device/phone name.",
"home_assistent_notification_action_helptext": "A list of Notification Actions can be found in Home Assistant under \"Developer Tools > Actions\". Search for \"notify\" to find your actions. Enter only the part after \"notify.\", e.g. for the action \"notify.mobile_app_xyz\" enter \"mobile_app_xyz\". For built-in mobile notifications, look for \"Send a notification via mobile_app_xyz\" (not \"Send a notification\").",
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@matthewCmatt could you review if this is what you meant?

@CommanderStorm CommanderStorm marked this pull request as ready for review March 10, 2026 07:03
Copilot AI review requested due to automatic review settings March 10, 2026 07:03
@github-actions github-actions bot added the pr:needs review this PR needs a review by maintainers or other community members label Mar 10, 2026
@CommanderStorm CommanderStorm changed the title Update Home Assistant notification help text for HA 2024 Services→Actions rename fix: Update Home Assistant notification help text for HA 2024 Services→Actions rename Mar 10, 2026
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the Home Assistant notification configuration help text in Uptime Kuma to reflect the 2024 Home Assistant terminology change from "Services" to "Actions". It updates labels, help descriptions, and an example YAML snippet shown to users when configuring Home Assistant notifications.

Changes:

  • Renamed the field label from "Notification Service" to "Notification Action" and updated the help text to reference "Developer Tools > Actions" instead of "Developer Tools > Services", with additional clarification about entering only the suffix after notify.
  • Updated the automation trigger example from call_service to call_action and the YAML snippet from service:/service_data: to action:/data:
  • Replaced the long inline translation string with a new programmatic translation key for the help text

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
src/lang/en.json Updated translation strings: renamed label key, replaced long help text with a new key, and improved help text content
src/components/notifications/HomeAssistant.vue Updated label reference, switched to new translation key for help text, updated event type and YAML snippet to match HA 2024 terminology

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@CommanderStorm
Copy link
Collaborator

@tr4nt0r could you maybe give the new wording a look over?
I have never used HA..

Copy link
Contributor

@tr4nt0r tr4nt0r left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it's still call_service and service_data, that hasn't changed and the new location for the developer tools is Settings > Developer Tools > Actions

Co-authored-by: Manu <4445816+tr4nt0r@users.noreply.github.com>
CommanderStorm and others added 2 commits March 10, 2026 13:08
Co-authored-by: Manu <4445816+tr4nt0r@users.noreply.github.com>
Co-authored-by: Manu <4445816+tr4nt0r@users.noreply.github.com>
@CommanderStorm CommanderStorm enabled auto-merge (squash) March 10, 2026 12:09
Copy link
Collaborator

@CommanderStorm CommanderStorm left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @tr4nt0r

@CommanderStorm CommanderStorm merged commit 0462b6f into master Mar 10, 2026
24 checks passed
@matthewCmatt
Copy link

matthewCmatt commented Mar 10, 2026

@CommanderStorm I haven't contributed before, but shouldn't the translation key here (homeAssistantNotificationActionHelptext) be updated in all translation json documents? I think testing this in a non-english translation should happen.

@matthewCmatt
Copy link

@CommanderStorm I haven't contributed before, but shouldn't the translation key here (homeAssistantNotificationActionHelptext) be updated in all translation json documents? I think testing this in a non-english translation should happen.

Also the new key Notification Action

@CommanderStorm CommanderStorm deleted the copilot/update-home-assistant-notification-text branch March 10, 2026 14:01
@CommanderStorm
Copy link
Collaborator

but shouldn't the translation key be updated in all translation json documents

No, this is intentional to not break our sync with weblate.
I don't speak all the languages we have, so we need to offload this to our awsome community of translators.

If you speak a non-english languages and want to improve our translations for that, we would be happy to have you -> https://weblate.kuma.pet/projects/uptime-kuma/uptime-kuma/

@matthewCmatt
Copy link

No, this is intentional to not break our sync with weblate.

Gotcha, thanks for clarifying.

Thanks for the quick PR! Well done

@CommanderStorm
Copy link
Collaborator

assigning to copilot is simple enough for small, well worded issue feedback like you provided. Thanks for that!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

pr:needs review this PR needs a review by maintainers or other community members

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update Home Assistant notification help text

5 participants