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

# Tier List Builder

> Build, edit, and share tier lists from a canvas-based editor. Pick a template, drop in images and labels, sort by drag, export as PNG or share a live link.

The tier list builder is a canvas-based editor for ranking anything: players, agents, champions, weapons, teams, anything you can drop an image and a label on. Save your work, share via link, or export to PNG.

<Card title="Open the tier list builder" icon="layer-group" href="https://esportshub.io/activities/tierlist">
  Browse templates and start a new tier list.
</Card>

## Templates

The builder ships with four starting templates. Pick whichever shape fits and customise from there:

| Template            | Rows                  | Use for                                           |
| ------------------- | --------------------- | ------------------------------------------------- |
| **S to F**          | S, A, B, C, D, F      | The default. Six-row classic.                     |
| **S to D**          | S, A, B, C, D         | Five-row variant when F-tier feels like overkill. |
| **Top / Mid / Low** | Top, Mid, Low         | Quick three-bucket sort for casual ranking.       |
| **Tier 1-5**        | Tier 1 through Tier 5 | Numbered instead of lettered, neutral phrasing.   |

Each row has a default colour that matches the standard tier-list gradient (red → green → blue). You can recolour rows individually after picking a template.

## Editing

The canvas is split into the **row area** on the left and the **item tray** on the right.

* **Add items** by dragging images into the tray or pasting URLs. Each item is sized to a square thumbnail.
* **Rank an item** by dragging it from the tray into a row.
* **Reorder within a row** by dragging items horizontally.
* **Reorder rows** by dragging the row's drag handle on the left edge.
* **Rename a row** by clicking its label.
* **Recolour a row** from the colour swatch next to its label.
* **Add or remove rows** from the row menu (`+` button at the bottom of the row stack).

There's no fixed item limit per row, tier lists with 50+ items per row render fine. Performance falls off past a few hundred items total per list.

## Saving

Tier lists save **per-account** as soon as you make changes. The list appears in your gallery at `/activities/tierlist` with a thumbnail preview and last-edited timestamp.

You can keep as many tier lists as you want, including drafts. Each has its own URL, yours alone unless you share it.

## Sharing

Two ways to share:

* **Live link**: the tier list URL works for anyone with the link. They see exactly what you see, in real time. They can't edit. Useful for posting in Discord or social.
* **Image download**: the download button rasterises the current state to a PNG, stamped with an "ESPORTS HUB" watermark and no editor chrome. Drop it into a tweet, embed, or screenshot.

Live links don't expire. If you delete a tier list, the link breaks.

## Tournaments and templates

If you want to seed a tier list with current rosters or pro players from a specific scene, the AI Chat (`/chat`) can build the starting state for you. Ask something like "make a tier list of every Valorant agent" or "rank the current LCK roster" and it'll generate the canvas with item thumbnails pre-populated. Customise from there.
