# Guides

Upgrading from earlier versions of Clay, and solutions for common problems.

| If you … | Read |
|----------|------|
| Run a Clay 2 site | [Upgrading to Clay 3](https://clay-doc.github.io/clay-example-repo/3.x/guides/upgrading-to-clay-3.md) |
| Still build with Clay 1 and Clay Oven | [Migrating from Clay 1](https://clay-doc.github.io/clay-example-repo/3.x/guides/migrating-from-clay-1.md) |
| Hit a problem: missing styles, icons, images or dates, or a failing build | [Troubleshooting](https://clay-doc.github.io/clay-example-repo/3.x/guides/troubleshooting.md) |

> [!NOTE]
> Upgrading from Clay 1 to Clay 3? Follow both guides in order: first to Clay 2, then to Clay 3.

---

All pages of these docs, as Markdown for language models: https://clay-doc.github.io/clay-example-repo/3.x/llms.txt