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

# Folders & Tags

> Organize and label links using folders for primary grouping and tags for cross-cutting attributes.

<Tip>
  **Folders vs tags:** Use folders for primary grouping (one per link), such as campaign, client, or channel. Use tags for cross-cutting labels a link can belong to many of, such as status, quarter, or experiment flag. Think of a folder as the filing cabinet drawer and tags as sticky notes on the file.
</Tip>

Both folders and tags are managed from **Sidebar → Folders & Tags**.

<Frame>
  <img src="https://mintcdn.com/utm-e577acb5/_OFWyAVC_YtnhKc0/images/fodler&tags.png?fit=max&auto=format&n=_OFWyAVC_YtnhKc0&q=85&s=c25ebac3c8ec8dfc993b3ab6b65257c0" alt="Folders and Tags page - folder list with color indicators and tags panel" width="1920" height="991" data-path="images/fodler&tags.png" />
</Frame>

## Folders

Folders are flat containers for organizing links inside a workspace. Each folder is separate; folders don't support nesting. Each link belongs to zero or one folder. Unfiled links live in **Unsorted**.

### When to use folders

* 30+ links per workspace.
* Per-campaign or per-client grouping.
* Anytime your link list takes more than a glance to scan.

If you only need light grouping, tags are cheaper - links can have many tags but only one folder.

### How to use folders

<Steps>
  <Step title="Create a folder">
    Sidebar → **Folders & Tags**. Name it (case-insensitive unique per workspace), pick a color.
  </Step>

  <Step title="Set a default">
    Mark one folder as **Default**. The link builder uses this as the pre-selected folder when you create a new link. Only one default at a time per workspace.
  </Step>

  <Step title="Move links in">
    From the link list: select links → **Move to folder**.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/utm-e577acb5/_OFWyAVC_YtnhKc0/images/foldercreation.png?fit=max&auto=format&n=_OFWyAVC_YtnhKc0&q=85&s=b5bd4f26539dcf3404ff7d8b4f44ab52" alt="Create Folder modal - name field and 8-color picker" width="1920" height="991" data-path="images/foldercreation.png" />
</Frame>

### Folder common mistakes

<AccordionGroup>
  <Accordion title="One mega folder">
    Putting 800 links in "All Campaigns" defeats the point. Split links into separate folders by campaign, client, or quarter.
  </Accordion>

  <Accordion title="Same name twice">
    Folder names are case-insensitive unique per workspace. `Email` and `email` collide.
  </Accordion>

  <Accordion title="Expecting subfolders">
    Folders don't contain other folders. Use clear folder names, such as `Q2 Launch - Email`, or use tags for cross-cutting labels.
  </Accordion>
</AccordionGroup>

***

## Tags

Tags are color-coded labels on links. Each link can have many tags. Each tag belongs to one workspace. Use them for any cross-cutting attribute that doesn't fit a single flat folder.

### When to use tags

* Status: `active`, `paused`, `draft`.
* Channel cohort: `paid-search`, `paid-social`, `email`.
* Quarterly review: `q2-2025`, `q3-2025`.
* A/B variants you might compare across campaigns.

### How to use tags

<Steps>
  <Step title="Create a tag">
    Sidebar → **Folders & Tags** → **Create tag**. Name it (case-insensitive unique per workspace), pick a color (default orange).
  </Step>

  <Step title="Apply on a link">
    From the link builder or the Links list: select the link → **Tags** → pick one or more.
  </Step>

  <Step title="Bulk-tag">
    On the Links list: select multiple links → **Bulk Tag** → add tags.

    * **Add** mode appends without removing existing tags.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/utm-e577acb5/_OFWyAVC_YtnhKc0/images/createtag.png?fit=max&auto=format&n=_OFWyAVC_YtnhKc0&q=85&s=bd948b0389516e4985ac6b801d6a350c" alt="Create Tag modal - name field and color picker" width="1920" height="991" data-path="images/createtag.png" />
</Frame>

### Tag common mistakes

<AccordionGroup>
  <Accordion title="Folders pretending to be tags">
    Creating folders for each status (`active`, `paused`)? Use tags. Folders are separate containers for links, not nested hierarchies.
  </Accordion>

  <Accordion title="Duplicate names">
    Tag names are case-insensitive unique per workspace. `Email` and `email` collide.
  </Accordion>

  <Accordion title="Color overload">
    More than 8-10 colors becomes visual noise. Reuse colors with distinct names.
  </Accordion>
</AccordionGroup>

## Edge cases

<Note>
  Both tags and Folders can be renamed from the 3 dot menu in the Folders & Tags panel.
</Note>

<Note>
  **Deleting a tag** removes it from every link automatically. Click history is unaffected.
</Note>

## Real-world example

Agency managing a client campaign:

```text theme={null}
Folders:
Acme Corp - Paid Search
Acme Corp - Paid Social
Acme Corp - Email

Tags applied across folders:
experiment    (purple)   - A/B test variants
seasonal      (yellow)   - tied to a season or holiday
archive-q1    (gray)     - last quarter, kept for reporting
```

A single link can live in `Acme Corp - Email` and also carry `experiment` + `seasonal` tags. Filter by tag to see cross-folder cohorts instantly.
