Comment/Notes into Automation UI Editor

Hello everyone,

I would love to see a feature that allows us to leave custom comments or text notes directly inside the Automation UI Editor.

The Problem:
When creating complex automations with specific values or specific behaviors, it’s easy to forget long after why it was programmed that way. When coming back to an automation months later, I am sometimes completely lost, wondering why I set a specific value or what the exact logic behind it was. Having comments would save me a lot of time by immediately reminding me of the context.

The Proposal:
It would be amazing to have a dedicated "Comment" or "Notes" card/field that we can add anywhere within the visual editor (or attached to specific triggers/actions).

  • This field would just store plain text or markdown notes for the user.
  • It would not affect the execution of the automation at all (similar to # comments in YAML).
  • It would allow us to document our thought process directly in the UI, making maintenance much easier months down the road.

A dedicated, visible comment/notes section would be a massive quality-of-life improvement for visual programming.

What do you think?

Thank you to the dev team for the amazing work!

Feature requests are made on github, not the forum. home-assistant · Discussions · GitHub

However I suggest you search the forum for this request to see why it is not feasible and what feature ("alias") the devs introduced to address this.

And as has just been pointed out to me by another helpful forum member, your request has been implemented in the next version:

Thanks @Didgeridrew