# Managing Tags & discriptions

**URL:** https://kopia.discourse.group/t/managing-tags-discriptions/881
**Category:** Support
**Created:** [January 25, 2022, 3:01pm UTC](https://kopia.discourse.group/t/managing-tags-discriptions/881 "2022-01-25T15:01:00Z")
**Posts on this page:** 8
**Page:** 1

<div class="post-metadata">

### Author: ![saviodsouza](https://yyz2.discourse-cdn.com/free1/user_avatar/kopia.discourse.group/saviodsouza/32/50_2.png) [@saviodsouza](https://kopia.discourse.group/u/saviodsouza)
#### Post date: [January 25, 2022, 3:01pm UTC](https://kopia.discourse.group/t/managing-tags-discriptions/881/1 "2022-01-25T15:01:00Z")

</div>

how to use tags?  
`kopia snap create E: --tags=portableapps:myname`

how to filter by tags  
`kopia snap list --tags=portableapps:myname`

Now how do I remember all my tags? 🤔  
`kopia snap list`  
will only show all snapshots but won’t show tags. or discriptions

how to I list tags and discriptions?

Thanks 🙂  
sd

---

<div class="post-metadata">

### Author: ![tddostu](https://yyz2.discourse-cdn.com/free1/user_avatar/kopia.discourse.group/tddostu/32/325_2.png) [@tddostu](https://kopia.discourse.group/u/tddostu)
#### Post date: [February 4, 2022, 2:19am UTC](https://kopia.discourse.group/t/managing-tags-discriptions/881/2 "2022-02-04T02:19:16Z")

</div>

Interested in your questions, but I’d to also add:

Can I add a tag to an _existing_ snapshot? I noticed that I can ‘pin’ a snapshot (so it doesn’t get removed by a retention policy), but I’d love to be able to label/tag it so I can remember why I pinned it in the future.

---

<div class="post-metadata">

### Author: ![kris](https://avatars.discourse-cdn.com/v4/letter/k/82dd89/32.png) [@kris](https://kopia.discourse.group/u/kris)
#### Post date: [February 4, 2022, 10:31am UTC](https://kopia.discourse.group/t/managing-tags-discriptions/881/3 "2022-02-04T10:31:07Z")

</div>

You can see the descriptions in the json output.

From there you can filter with [jq](https://stedolan.github.io/jq/)

For example `kopia snap list --json | jq .[0]`

It’s quite awkward (I haven’t yet managed to see all snapshots with the descriptions).

I hope it could be implemented directly in the UI (tags and descriptions).

---

<div class="post-metadata">

### Author: ![tddostu](https://yyz2.discourse-cdn.com/free1/user_avatar/kopia.discourse.group/tddostu/32/325_2.png) [@tddostu](https://kopia.discourse.group/u/tddostu)
#### Post date: [February 5, 2022, 1:18pm UTC](https://kopia.discourse.group/t/managing-tags-discriptions/881/4 "2022-02-05T13:18:21Z")

</div>

For anyone coming across this, it turns out you can ‘tag’ a snapshot, instead you ‘pin’ it. This stops it being deleted by a retention policy and lets you add a name. Like so:  
` kopia snapshot pin <snapshot ID> --add=nameyouwant`

These don’t yet show up in the UI, but hopefully down the track that will be possible.

---

<div class="post-metadata">

### Author: ![jkowalski](https://yyz2.discourse-cdn.com/free1/user_avatar/kopia.discourse.group/jkowalski/32/3_2.png) [@jkowalski](https://kopia.discourse.group/u/jkowalski)
#### Post date: [February 8, 2022, 5:53am UTC](https://kopia.discourse.group/t/managing-tags-discriptions/881/5 "2022-02-08T05:53:11Z")

</div>

I have a prototype of the UI changes to support pins and descriptions:

Please take a look: [https://github.com/kopia/htmlui/pull/33](https://github.com/kopia/htmlui/pull/33)

Feedback is appreciated.

---

<div class="post-metadata">

### Author: ![wechsler](https://avatars.discourse-cdn.com/v4/letter/w/e68b1a/32.png) [@wechsler](https://kopia.discourse.group/u/wechsler)
#### Post date: [February 8, 2022, 11:47am UTC](https://kopia.discourse.group/t/managing-tags-discriptions/881/6 "2022-02-08T11:47:37Z")

</div>

Thanks for introducing these changes!  
I would be very happy to see them in the next release of KopiaUI

---

<div class="post-metadata">

### Author: ![tddostu](https://yyz2.discourse-cdn.com/free1/user_avatar/kopia.discourse.group/tddostu/32/325_2.png) [@tddostu](https://kopia.discourse.group/u/tddostu)
#### Post date: [February 9, 2022, 3:15am UTC](https://kopia.discourse.group/t/managing-tags-discriptions/881/7 "2022-02-09T03:15:50Z")

</div>

Love it 👍 Makes complete sense to me. Excellent work as usual!

---

<div class="post-metadata">

### Author: ![b3ta](https://avatars.discourse-cdn.com/v4/letter/b/2acd7d/32.png) [@b3ta](https://kopia.discourse.group/u/b3ta)
#### Post date: [July 18, 2024, 2:35pm UTC](https://kopia.discourse.group/t/managing-tags-discriptions/881/8 "2024-07-18T14:35:19Z")

</div>

Is it possible to have snapshot names at the level where snapshot _definitions_ are listed, and not only at the level where individual snapshots are listed?

So if you have some project and need different kinds of snapshots, all starting at the same root, you could differentiate between them by name and optional description for further detail. Sample snapshot names, all starting at `/home/fred/BIG_PROJECT`:

- Source code
- CI/CD logs
- Object code
- Documentation

My use case is that I need to have various snapshot definitions with different in/exclude and retention rules, all of which are applied from the same directory, so I have no easy way of differentiating between them at the level of the table which gets displayed when you click on the Snapshots tab in the main UI.
