---
# System prepended metadata

title: Astro 4.0 Migrations - Common Pitfalls

---

# Astro 4.0 Migrations - Common Pitfalls

This document records common issues people encounter as they upgrade to Astro 4.0.

---

### `astro-icon`

People are unable to use `astro-icon` in 4.0

#### How to fix

Update to version `0.8.2` (see [`CHANGELOG.md`](https://github.com/natemoo-re/astro-icon/blob/main/packages/core/CHANGELOG.md#082))

---




<!-- TEMPLATE

### {Issue Name}

Describe your issue

#### How to fix

Describe the fix (if one exists)

---

-->
