> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/edpets/core/tiers.md).

# Tiers

Pet rarities live in `tiers.yml`. Tiers drive sorting, the `{tier}` item placeholder and [bulk delete](/p/edpets/customization/guis.md).

```yaml
tiers:
  legendary:
    name: 'Legendary'
    color: '&6'
    weight: 1        # lower weight = rarer = sorts first
  common:
    name: 'Common'
    color: '&7'
    weight: 5
```

Add as many tiers as you like — a pet references its tier by id in `settings.tier`. Rarity upgrades (the **Rarity Scroll**) transform a pet into its `fusion.fuse-into` target, so a tier ladder is expressed as a chain of pet types (`dragon → rare-dragon → epic-dragon`).