# Tags Management {#tags-management}


Organize entities with a flexible tagging system.


## Overview {#overview}


Tags provide flexible categorization across all major entities:

- Tasks, projects, employees
- Contacts, deals, invoices
- Expenses, income, equipment


## Tag Structure {#tag-structure}


| Field      | Type   | Description        |
| ---------- | ------ | ------------------ |
| `name`     | string | Tag label          |
| `color`    | string | Hex color code     |
| `icon`     | string | Optional icon      |
| `isSystem` | bool   | System-created tag |


## Managing Tags {#managing-tags}



### Create Tags {#create-tags}


1. Go to **Settings** → **Tags**
2. Click **Add Tag**
3. Enter name and select color
4. Save


### Apply Tags {#apply-tags}


Tags can be applied to any entity:

```json
POST /api/task
{
  "title": "My Task",
  "tags": [
    { "id": "tag-uuid-1" },
    { "id": "tag-uuid-2" }
  ]
}
```


### Filter by Tags {#filter-by-tags}


Use tag filters in list views to find tagged entities:

```
GET /api/task?tags[]=tag-uuid-1&tags[]=tag-uuid-2
```


## Use Cases {#use-cases}


| Use Case   | Tags Example                |
| ---------- | --------------------------- |
| Priority   | `Urgent`, `High`, `Low`     |
| Department | `Engineering`, `Marketing`  |
| Client     | `Client A`, `Client B`      |
| Type       | `Bug`, `Feature`, `Support` |
| Status     | `Blocked`, `Needs Review`   |


## Related Pages {#related-pages}


- [Tags & Skills Endpoints](https://sourcey-gauzy.pages.dev/api/tags-and-skills-endpoints/index.md) — API
- [Skills Management](https://sourcey-gauzy.pages.dev/features/skills-management/index.md) — skills system