From 7d767ffc4bf5e1cf886aba6c2dffd0f3ebb09b15 Mon Sep 17 00:00:00 2001
From: Brandon Harvey <8107750+bharvey88@users.noreply.github.com>
Date: Mon, 20 Jul 2026 11:24:26 -0500
Subject: [PATCH] Add AQI component dialog steps to SEN65 NowCast AQI section
(#1040)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
The NowCast AQI section told readers to add the AQI component but not
how the dialog works. Add the four steps: select the AQI component, set
Calculation Type to AQI (or CAQI in Europe), pick the PM sensors in the
PM 10 0 and PM 2 5 dropdowns, and enter NowCast AQI for the name. Also
add a pointer after the main Device Builder steps so readers discover
the optional AQI sensor.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
---
.../modules/breakout-addons/sen65-air-quality-sensor.md | 9 ++++++++-
1 file changed, 8 insertions(+), 1 deletion(-)
diff --git a/docs/products/ESPHome-Starter-Kit/modules/breakout-addons/sen65-air-quality-sensor.md b/docs/products/ESPHome-Starter-Kit/modules/breakout-addons/sen65-air-quality-sensor.md
index e5e0e841b3..26641db61a 100644
--- a/docs/products/ESPHome-Starter-Kit/modules/breakout-addons/sen65-air-quality-sensor.md
+++ b/docs/products/ESPHome-Starter-Kit/modules/breakout-addons/sen65-air-quality-sensor.md
@@ -41,6 +41,8 @@ The SEN65 takes two components in your device config: the I2C bus it talks on, a

+Want a single air quality number on top of the individual readings? Add the AQI component too, see [NowCast AQI](#nowcast-aqi) below.
+
??? note "What the SEN65 YAML does"
Adding the SEN6x component, plus an AQI sensor for the [NowCast AQI](#nowcast-aqi) below, gives you a config like this:
@@ -135,7 +137,12 @@ The SEN65 takes two components in your device config: the I2C bus it talks on, a
### NowCast AQI
-Comparing µg/m³ values across PM1, PM2.5, PM4, and PM10 gets fiddly. The AQI component folds your PM2.5 and PM10 into a single 0-500 number that maps to the categories in the table above: bigger is worse. Add it in Device Builder pointed at your SEN65's PM2.5 and PM10 sensors.
+Comparing µg/m³ values across PM1, PM2.5, PM4, and PM10 gets fiddly. The AQI component folds your PM2.5 and PM10 into a single 0-500 number that maps to the categories in the table above: bigger is worse.
+
+1. In Device Builder, click **Add Component** and select the AQI component.
+2. Set **Calculation Type** to **AQI**, or **CAQI** if you're in Europe.
+3. Pick your SEN65's PM sensors in the **PM 10 0** and **PM 2 5** dropdowns.
+4. Enter `NowCast AQI` for the **Name**, then click **Add** and flash the device.
!!! tip "Rename the entity to NowCast AQI"