# Tags

Wdid has an automatic tag-parsing system. By using correctly structured tags into your item data, wdid will be able to parse them out and [filter](https://j-osler.gitbook.io/wdid/advanced/filters) using them, as well as display them nicely.

```
$ wdid add "go with @tanya to get #groceries. #home"
⇒ ok0jba -- Sun, 10 Nov 2019 14:35:01
Tags: [@tanya #groceries #home]
Data:
go with @tanya to get #groceries. #home
```

In this example, we added an item with three tags - one prefixed by `@`, the others by `#`. Wdid will recognize either as a tag - they don't convey any special different meaning - though I find using the `@` prefix to denote people is useful.

Wdid parsed these out and will display them in the `show` output as well as the list.

```
- Sun Nov 10
⇒ dewjba     remember the milk
⇒ ok0jba     go with @tanya to get #groceries. #home [@tanya #groceries #home]
```

{% hint style="info" %}
When referring to tags when listing in other places, use the full tag name, prefix included. E.g. `#home` or `@tanya`. Not `home` or `tanya`.
{% endhint %}

### **Tag Colors**

Each tag gets assigned a unique colour that will propagate throughout the system.

### **List Tags**

We can use the tag list command to show all tags we've created so far (not which items were tagged, but the tags themselves).

```
$ wdid tag-ls
@josler
#pr
#meeting
```

You can search for items by tag with our advanced listing [filter](https://j-osler.gitbook.io/wdid/advanced/filters) language.