> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aisync.link/llms.txt
> Use this file to discover all available pages before exploring further.

# PowerList Tags

**PowerList Tag** lets you create and manage labels for your PowerLists so teams can group lists consistently (for example by priority, campaign type, or follow-up state). Each tag can also be restricted by role, so only selected roles can view/use it.

<img src="https://mintcdn.com/rizler/qfIPW4E7Ajy_Ilf2/images/manage/tags/powerlist-tag-overview.png?fit=max&auto=format&n=qfIPW4E7Ajy_Ilf2&q=85&s=29318ddc9fef9143123b53a93430726a" alt="PowerList Tags list view" className="rounded-lg border shadow-sm" width="1656" height="618" data-path="images/manage/tags/powerlist-tag-overview.png" />

Use this page to maintain organization-wide PowerList tags.

A tag record includes:

* **Tag** name
* optional **role access links** (Assign role View)
* created/updated timestamps

## 🗂️ Main list

When you open the screen, you see a table of PowerList tags (typically newest first).

| Column         | Meaning                                  |
| -------------- | ---------------------------------------- |
| **#**          | Row number in current list view.         |
| **Tag**        | Tag label name.                          |
| **Updated At** | Last modified date/time (your timezone). |
| **Created At** | First created date/time (your timezone). |
| **Action**     | Edit/delete controls for that row.       |

### ⚙️ List controls

* **Add** opens create form.
* **Search** filters rows (`Search...` placeholder).
* Pagination keeps long lists easy to scan (often 10 rows/page by default).

## ➕ Adding a new tag

1. Click **Add**.
2. List hides and **Add PowerList Tag** form opens.
3. Fill fields.
4. Click **Submit**.

While saving, a short message like **Please wait. Action in process...** may appear.

* On success: green confirmation + page refresh/list reload.
* On failure: red message with reason.

<img src="https://mintcdn.com/rizler/qfIPW4E7Ajy_Ilf2/images/manage/tags/powerlist-tag-edit.png?fit=max&auto=format&n=qfIPW4E7Ajy_Ilf2&q=85&s=db1dd0ef3aab2c33bd9853dbbae50d79" alt="Edit PowerList Tag form" className="rounded-lg border shadow-sm" width="1672" height="407" data-path="images/manage/tags/powerlist-tag-edit.png" />

## ✏️ Editing a tag

1. Click **Edit** in the row.
2. **Edit PowerList Tag** form opens with existing values loaded.
3. Update **Tag** and/or **Assign role View**.
4. Click **Submit**.

Save behavior is same as Add (wait message, success/error, then list refresh on success).

<img src="https://mintcdn.com/rizler/qfIPW4E7Ajy_Ilf2/images/manage/tags/powerlist-tag-add.png?fit=max&auto=format&n=qfIPW4E7Ajy_Ilf2&q=85&s=e8013d5c70387e262cfc32d542cbc63b" alt="Add PowerList Tag form" className="rounded-lg border shadow-sm" width="1672" height="395" data-path="images/manage/tags/powerlist-tag-add.png" />

## 📝 Form fields

**🏷️ Tag (required)**

* The visible label name used across PowerList screens.
* Required before submit.
* Max length is typically up to 100 characters.
* Help tooltip explains this field is for categorizing/organizing PowerLists.

**👥 Assign role View**

* Multi-select list of organization roles.
* Choose one or more roles allowed to view/use this tag.
* Searchable picker makes long role lists easier.
* Help text explains multi-role access behavior.

**🗑️ Deleting a tag**

1. Click row trash icon.
2. Confirm prompt (**Are you sure?**).

If successful:

* tag is removed,
* linked role assignments for that tag are removed,
* list reloads with success message.

If not found or another error occurs, an error message appears.

<Warning>
  Delete is permanent for that tag record. Confirm before deleting tags used in active PowerList workflows.
</Warning>
