Skip to content

Add documentation for Indoor Air Quality integration#45107

Open
liudger wants to merge 3 commits intohome-assistant:nextfrom
liudger:add-indoor-air-quality
Open

Add documentation for Indoor Air Quality integration#45107
liudger wants to merge 3 commits intohome-assistant:nextfrom
liudger:add-indoor-air-quality

Conversation

@liudger
Copy link
Copy Markdown
Contributor

@liudger liudger commented Apr 30, 2026

Proposed change

Add documentation for new integration Indoor Air Quality. It now uses UK based calculations for the air quality on multiple sensors. Other calculations can be added in additional pull requests.

Type of change

  • Spelling, grammar or other readability improvements (current branch).
  • Adjusted missing or incorrect information in the current documentation (current branch).
  • Added documentation for a new integration I'm adding to Home Assistant (next branch).
  • Added documentation for a new feature I'm adding to Home Assistant (next branch).
  • Removed stale or deprecated documentation.

Additional information

Checklist

  • This PR uses the correct branch, based on one of the following:
    • I made a change to the existing documentation and used the current branch.
    • I made a change that is related to an upcoming version of Home Assistant and used the next branch.
  • The documentation follows the Home Assistant documentation standards.

@home-assistant home-assistant Bot added in-progress This PR/Issue is currently being worked on needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch next This PR goes into the next branch labels Apr 30, 2026
@home-assistant
Copy link
Copy Markdown

It seems that this PR is targeted against an incorrect branch. Documentation updates which apply to our current stable release should target the current branch. Please change the target branch of this PR to current and rebase if needed. If this is documentation for a new feature, please add a link to that PR in your description.

@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 30, 2026

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit 31fe39a
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/69f362d9f21c070008dde84a
😎 Deploy Preview https://deploy-preview-45107--home-assistant-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@home-assistant home-assistant Bot added has-parent This PR has a parent PR in another repo and removed needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch labels Apr 30, 2026
@liudger liudger marked this pull request as ready for review April 30, 2026 14:00
Copilot AI review requested due to automatic review settings April 30, 2026 14:00
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new integration documentation page for the Indoor Air Quality helper, describing how to combine multiple environmental sensor readings into a single IAQ score and level in Home Assistant.

Changes:

  • Added a new integration doc page for indoor_air_quality, including setup and options via config flow.
  • Documented supported source sensor types, generated entities, and recalculation behavior.
  • Included limitations, troubleshooting guidance, and standard removal steps.

Comment thread source/_integrations/indoor_air_quality.markdown Outdated
Comment thread source/_integrations/indoor_air_quality.markdown Outdated
Humidity sensor:
description: Optional humidity source used for the air quality calculation.
Carbon dioxide sensor:
description: Optional CO2 source used for the air quality calculation.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should be fine as is

Comment on lines +2 to +8
title: Indoor Air Quality
description: Combine temperature, humidity, gas, and particulate sensor readings into a single indoor air quality score in Home Assistant.
ha_category:
- Environment
- Helper
- Sensor
ha_release: 2026.5
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

? should be ok

liudger and others added 2 commits April 30, 2026 16:06
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

has-parent This PR has a parent PR in another repo in-progress This PR/Issue is currently being worked on next This PR goes into the next branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants