Home Assistant Repair Issues

Repair issues provide actionable notifications to users about problems that require attention. Gold tier IQS requirement.

When to Use Repairs

Use repair issues for:

• Configuration problems the user can fix
• Firmware updates available
• Deprecated features being used
• Missing optional dependencies
• Service disruptions with user action needed

Do NOT use for:

• Transient errors (use logging)
• Entity unavailability (use available property)
• Internal errors (use exceptions)

Basic Implementation