From 53df69ee6eebcebd72e6bb31b0e1bfda4acbb787 Mon Sep 17 00:00:00 2001
From: Timothy <6560631+TimoPtr@users.noreply.github.com>
Date: Wed, 30 Apr 2025 20:45:26 +0200
Subject: [PATCH] Encourage to use UID instead of name for update and delete
 todos (#143556)

---
 homeassistant/components/todo/services.yaml |  1 +
 homeassistant/components/todo/strings.json  | 12 ++++++------
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/homeassistant/components/todo/services.yaml b/homeassistant/components/todo/services.yaml
index 07f91e12e22..8c26b8e9c76 100644
--- a/homeassistant/components/todo/services.yaml
+++ b/homeassistant/components/todo/services.yaml
@@ -100,6 +100,7 @@ remove_item:
   fields:
     item:
       required: true
+      example: "Submit income tax return"
       selector:
         text:
 
diff --git a/homeassistant/components/todo/strings.json b/homeassistant/components/todo/strings.json
index f02842349ad..1354ab6777b 100644
--- a/homeassistant/components/todo/strings.json
+++ b/homeassistant/components/todo/strings.json
@@ -40,11 +40,11 @@
     },
     "update_item": {
       "name": "Update item",
-      "description": "Updates an existing to-do list item based on its name.",
+      "description": "Updates an existing to-do list item based on its name or UID.",
       "fields": {
         "item": {
-          "name": "Item name",
-          "description": "The current name of the to-do item."
+          "name": "Item name or UID",
+          "description": "The name/summary of the to-do item. If you have items with duplicate names, you can reference specific ones using their UID instead."
         },
         "rename": {
           "name": "Rename item",
@@ -74,11 +74,11 @@
     },
     "remove_item": {
       "name": "Remove item",
-      "description": "Removes an existing to-do list item by its name.",
+      "description": "Removes an existing to-do list item by its name or UID.",
       "fields": {
         "item": {
-          "name": "Item name",
-          "description": "The name for the to-do list item."
+          "name": "[%key:component::todo::services::update_item::fields::item::name%]",
+          "description": "[%key:component::todo::services::update_item::fields::item::description%]"
         }
       }
     }