# Stored Tag Description

**URL:** <https://forum.inductiveautomation.com/t/stored-tag-description/78458>\
**Category:** Ignition\
**Tags:** ignition81, perspective, database\
**Created:** [August 28, 2023, 4:32pm UTC](https://forum.inductiveautomation.com/t/stored-tag-description/78458 "2023-08-28T16:32:50Z")\
**Posts on this page:** 11\
**Page:** 1

<div class="post-metadata">

**Author:** ![Hana\_Bilowit](https://avatars.discourse-cdn.com/v4/letter/h/b4bc9f/32.png) [@Hana\_Bilowit](https://forum.inductiveautomation.com/u/Hana_Bilowit)\
**Post date:** [August 28, 2023, 4:32pm UTC](https://forum.inductiveautomation.com/t/stored-tag-description/78458/1 "2023-08-28T16:32:50Z")

</div>

Is there anywhere that tag descriptions are stored? I am seeing that tagpaths are stored but it would be nice to have a description that parses the tag path, like an alarm label. We are using the audit log but the tag paths can be confusing for the operators.

---

<div class="post-metadata">

**Author:** ![lrose](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/lrose/32/62724_2.png) [@lrose](https://forum.inductiveautomation.com/u/lrose)\
**Post date:** [August 28, 2023, 4:42pm UTC](https://forum.inductiveautomation.com/t/stored-tag-description/78458/2 "2023-08-28T16:42:55Z")

</div>

When you say tag description what do you mean?

---

<div class="post-metadata">

**Author:** ![Hana\_Bilowit](https://avatars.discourse-cdn.com/v4/letter/h/b4bc9f/32.png) [@Hana\_Bilowit](https://forum.inductiveautomation.com/u/Hana_Bilowit)\
**Post date:** [August 28, 2023, 4:47pm UTC](https://forum.inductiveautomation.com/t/stored-tag-description/78458/3 "2023-08-28T16:47:17Z")

</div>

The same function as an alarm label. A string that tells the user what the tag means/does.

---

<div class="post-metadata">

**Author:** ![lrose](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/lrose/32/62724_2.png) [@lrose](https://forum.inductiveautomation.com/u/lrose)\
**Post date:** [August 28, 2023, 5:17pm UTC](https://forum.inductiveautomation.com/t/stored-tag-description/78458/4 "2023-08-28T17:17:26Z")

</div>

You can use the displayPath property, or potentially the notes property if you are already using the display path.

---

<div class="post-metadata">

**Author:** ![Hana\_Bilowit](https://avatars.discourse-cdn.com/v4/letter/h/b4bc9f/32.png) [@Hana\_Bilowit](https://forum.inductiveautomation.com/u/Hana_Bilowit)\
**Post date:** [August 28, 2023, 5:23pm UTC](https://forum.inductiveautomation.com/t/stored-tag-description/78458/5 "2023-08-28T17:23:09Z")

</div>

is that property stored in a table in the database?

---

<div class="post-metadata">

**Author:** ![lrose](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/lrose/32/62724_2.png) [@lrose](https://forum.inductiveautomation.com/u/lrose)\
**Post date:** [August 28, 2023, 5:26pm UTC](https://forum.inductiveautomation.com/t/stored-tag-description/78458/6 "2023-08-28T17:26:10Z")

</div>

What database? It’s a property in the tag.

---

<div class="post-metadata">

**Author:** ![Felipe\_CRM](https://avatars.discourse-cdn.com/v4/letter/f/dfb087/32.png) [@Felipe\_CRM](https://forum.inductiveautomation.com/u/Felipe_CRM)\
**Post date:** [August 28, 2023, 5:34pm UTC](https://forum.inductiveautomation.com/t/stored-tag-description/78458/7 "2023-08-28T17:34:58Z")

</div>

For tags, there is a property called "Documentation" that you can use to store a tag description:

 ![image](https://us1.discourse-cdn.com/inductiveautomation/original/3X/2/b/2bfe4ed4b1e355a372702796562a5a4380967fdd.png)

I don't think there's any way to automatically access it on the audit log or anything, but you could access it through scripting or an expression:

 ![image](https://us1.discourse-cdn.com/inductiveautomation/original/3X/1/0/101712e783854c5ca0e6c474504cc93a6e6820f5.png)  
 ![image](https://us1.discourse-cdn.com/inductiveautomation/original/3X/3/e/3ea2746995dfc7d248fed4650d901845c0b26cc5.png)

---

<div class="post-metadata">

**Author:** ![Hana\_Bilowit](https://avatars.discourse-cdn.com/v4/letter/h/b4bc9f/32.png) [@Hana\_Bilowit](https://forum.inductiveautomation.com/u/Hana_Bilowit)\
**Post date:** [August 28, 2023, 5:59pm UTC](https://forum.inductiveautomation.com/t/stored-tag-description/78458/8 "2023-08-28T17:59:09Z")

</div>

It would be nice if it could be a column stored in the audit table.

---

<div class="post-metadata">

**Author:** ![lrose](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/lrose/32/62724_2.png) [@lrose](https://forum.inductiveautomation.com/u/lrose)\
**Post date:** [August 28, 2023, 6:05pm UTC](https://forum.inductiveautomation.com/t/stored-tag-description/78458/9 "2023-08-28T18:05:33Z")

</div>

I guess I’m a little lost on exactly what you’re asking because a tags alarm label isn’t kept in the audit log either.

Can you show what exactly you’re trying to accomplish and where you want this to be displayed?

---

<div class="post-metadata">

**Author:** ![Felipe\_CRM](https://avatars.discourse-cdn.com/v4/letter/f/dfb087/32.png) [@Felipe\_CRM](https://forum.inductiveautomation.com/u/Felipe_CRM)\
**Post date:** [August 28, 2023, 6:13pm UTC](https://forum.inductiveautomation.com/t/stored-tag-description/78458/10 "2023-08-28T18:13:08Z")

</div>

Depending on how you're trying to display it, you can whip up a transform on an audit log query that adds an extra column with the tag description and then display that in a table (or do the whole thing in a script instead of using a transform).

---

<div class="post-metadata">

**Author:** ![nminchin](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/nminchin/32/6911_2.png) [@nminchin](https://forum.inductiveautomation.com/u/nminchin)\
**Post date:** [August 29, 2023, 4:06am UTC](https://forum.inductiveautomation.com/t/stored-tag-description/78458/11 "2023-08-29T04:06:53Z")

</div>

What I think I would do, for efficiency, is to create a sql table which will hold a row for each tag in your system along with its description. Populate the table automatically and periodically via a script, or call it from the root of a project script library and it will run every time you save the project. Then when presenting the audit log, join onto this table so you can show tag descriptions as well. You could use this for other useful things as well like a custom historic tag browser.

Note that alarm properties like display path only update values after the alarm has gone active.
