diff --git a/docs/core/entity/air-quality.md b/docs/core/entity/air-quality.md
index a7a91fe1..fd2ee615 100644
--- a/docs/core/entity/air-quality.md
+++ b/docs/core/entity/air-quality.md
@@ -5,8 +5,11 @@ sidebar_label: Air Quality
 
 ## Properties
 
-:::tip
-Properties should always only return information from memory and not do I/O (like network requests). Implement `update()` or `async_update()` to fetch data.
+:::caution Deprecated
+The Air Quality entity is deprecated and should not be used. Instead, use
+separate sensors for these measurements.
+
+Integrations that still rely on the Air Quality Entity should be migrated.
 :::
 
 | Name | Type | Default | Description