# Adding "text comment" for flow explanation

**URL:** <https://community.homey.app/t/adding-text-comment-for-flow-explanation/31997>\
**Category:** Flows\
**Created:** [July 3, 2020, 1:16pm UTC](https://community.homey.app/t/adding-text-comment-for-flow-explanation/31997 "2020-07-03T13:16:48Z")\
**Posts on this page:** 11\
**Page:** 1

<div class="post-metadata">

**Author:** ![Ruud\_van\_Beek](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/ruud_van_beek/32/969_2.png) [@Ruud\_van\_Beek](https://community.homey.app/u/Ruud_van_Beek)\
**Post date:** [July 3, 2020, 1:16pm UTC](https://community.homey.app/t/adding-text-comment-for-flow-explanation/31997/1 "2020-07-03T13:16:48Z")

</div>

While most flows that I create are quite self-explaining, I have come to a point where it would be nice to add textual comments for more explanation.  
This is especially true after a few months, half-year or so when you want to change some small things. For complex flows (\> 20 cards + several or options) it takes quite some study to find the same brain waves as before.

Is there any way to add comments that I overlooked besides using an external document to hold flow explanations?

---

<div class="post-metadata">

**Author:** ![JPe4619](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jpe4619/32/9017_2.png) [@JPe4619](https://community.homey.app/u/JPe4619)\
**Post date:** [July 3, 2020, 2:57pm UTC](https://community.homey.app/t/adding-text-comment-for-flow-explanation/31997/2 "2020-07-03T14:57:37Z")

</div>

besides the Flow-Names and Flow-Folders, there is no “text comment” available (as far as I know).

![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/e/3/e3a00839f31e7c52703bfc039e4b4244c8e2c1f5.png)

---

<div class="post-metadata">

**Author:** ![anon61197305](https://avatars.discourse-cdn.com/v4/letter/a/8baadc/32.png) [@anon61197305](https://community.homey.app/u/anon61197305)\
**Post date:** [July 3, 2020, 3:04pm UTC](https://community.homey.app/t/adding-text-comment-for-flow-explanation/31997/3 "2020-07-03T15:04:34Z")

</div>

There isn’t an app for that. It would be nice though. Maybe report it as feedback?

---

<div class="post-metadata">

**Author:** ![robertklep](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/robertklep/32/160628_2.png) [@robertklep](https://community.homey.app/u/robertklep)\
**Post date:** [July 3, 2020, 4:14pm UTC](https://community.homey.app/t/adding-text-comment-for-flow-explanation/31997/4 "2020-07-03T16:14:06Z")

</div>

See also [this thread from almost two years ago](https://community.homey.app/t/flow-notes-description/624) and [this removed Github issue](https://webcache.googleusercontent.com/search?q=cache:FTD98duD4XcJ:https://github.com/athombv/homey/issues/2881+&cd=2&hl=en&ct=clnk&gl=nl).

---

<div class="post-metadata">

**Author:** ![Ruud\_van\_Beek](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/ruud_van_beek/32/969_2.png) [@Ruud\_van\_Beek](https://community.homey.app/u/Ruud_van_Beek)\
**Post date:** [July 4, 2020, 8:09am UTC](https://community.homey.app/t/adding-text-comment-for-flow-explanation/31997/5 "2020-07-04T08:09:55Z")

</div>

Ah, good to see that I’m not the only one requiring this. It seems to be no priority to @Athom though as previous is already \> 2 years…

One would think a simple text field should not be so much work? But then it not really a “sexy” feature to shine with…

Beside creating cluttered flow names, which I do not like, there seems to be not much alternative.

---

<div class="post-metadata">

**Author:** ![DirkG](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/dirkg/32/118897_2.png) [@DirkG](https://community.homey.app/u/DirkG)\
**Post date:** [July 4, 2020, 8:27am UTC](https://community.homey.app/t/adding-text-comment-for-flow-explanation/31997/6 "2020-07-04T08:27:05Z")

</div>

However, it may become a priority for Athom the more users officially submit this additional feature as a “Feature Request”.

---

<div class="post-metadata">

**Author:** ![Ruud\_van\_Beek](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/ruud_van_beek/32/969_2.png) [@Ruud\_van\_Beek](https://community.homey.app/u/Ruud_van_Beek)\
**Post date:** [July 6, 2020, 11:13am UTC](https://community.homey.app/t/adding-text-comment-for-flow-explanation/31997/7 "2020-07-06T11:13:58Z")

</div>

Blijkbaar moet dat hier?

> **[Feature request for Homey](https://docs.google.com/forms/d/e/1FAIpQLSc8j_GfID4adV4w5ogNtIX1-AqVWrkgIo3bOjkoNtqlHMM0xw/viewform)**
>
> If you have a feature request for Homey you can request this feature here. (we will do our best to include all request in the Homey software, but requesting a new feature does not automatically mean that it will be added in a future update)
> 
> Please...

Ik heb het ingevuld, benieuwd of ze er iets mee gaan doen…

---

<div class="post-metadata">

**Author:** ![DirkG](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/dirkg/32/118897_2.png) [@DirkG](https://community.homey.app/u/DirkG)\
**Post date:** [July 6, 2020, 1:27pm UTC](https://community.homey.app/t/adding-text-comment-for-flow-explanation/31997/8 "2020-07-06T13:27:42Z")

</div>

Ik kan je niet verstaan. In English please.

Yes, this is the correct form.  
Nobody can tell you if it’ll have any effect. The more this feature is requested at Athom, the higher it will be prioritized (hopefully).

---

<div class="post-metadata">

**Author:** ![FKey](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/fkey/32/14793_2.png) [@FKey](https://community.homey.app/u/FKey)\
**Post date:** [July 10, 2020, 8:06pm UTC](https://community.homey.app/t/adding-text-comment-for-flow-explanation/31997/9 "2020-07-10T20:06:14Z")

</div>

One of my newyears resolutions was: build my own app for homey.  
Beeing apple to add comments to my flows has been a big wish since I bought homey.

So I picked it as my first project.  
It turned out to be more simple then I thought.  
I am currently testing it and it feels pretty could already

I opened a thread for the app already “[comments for flow](https://community.homey.app/t/app-comments-for-flow-simple-cards-to-add-comments-to-your-flows-v0-0-1/32251)”

Its not published yet, need to do some more testing first

---

<div class="post-metadata">

**Author:** ![Ruud\_van\_Beek](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/ruud_van_beek/32/969_2.png) [@Ruud\_van\_Beek](https://community.homey.app/u/Ruud_van_Beek)\
**Post date:** [July 11, 2020, 6:47am UTC](https://community.homey.app/t/adding-text-comment-for-flow-explanation/31997/10 "2020-07-11T06:47:39Z")

</div>

Sounds like exactly what I was looking for 🙂  
Please put me on your list to test the app once available.

---

<div class="post-metadata">

**Author:** ![Danny\_Bartel](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/danny_bartel/32/34928_2.png) [@Danny\_Bartel](https://community.homey.app/u/Danny_Bartel)\
**Post date:** [August 18, 2021, 8:47pm UTC](https://community.homey.app/t/adding-text-comment-for-flow-explanation/31997/11 "2021-08-18T20:47:38Z")

</div>

Hi! Are you aware that your challenge is solved, by using the standard app **FlowComment**?

I use it a lot. The are 2 types of comments: a _Comment_ and a _FixtThis_

Enjoy 🙂

/Danny
