HACS dashboard doesn't show local brand icons (HA 2026.3+)

[spagonisky]

Description

Starting with Home Assistant 2026.3, custom integrations can ship their own brand images in a �rand/ directory inside the integration folder. The home-assistant/brands repository no longer accepts PRs for custom integrations (see announcement).

HA serves these icons via the local API at /api/brands/integration/{domain}/icon.png, and they display correctly on the Integrations page, device pages, and everywhere else in the HA frontend.

However, the HACS dashboard still fetches icons from data-v2.hacs.xyz, which doesn't have icons for custom integrations that only provide local brand assets. This results in a missing/blank icon in the HACS store listing.

Steps to reproduce

1. Create a custom integration with a \�rand/\ folder containing \icon.png\ (following the HA docs)
2. Add the repo as a custom repository in HACS
3. The icon appears blank/missing in the HACS dashboard
4. The same icon works correctly on the HA Integrations page (/api/brands/integration/{domain}/icon.png\ returns 200)

Expected behavior

HACS should fall back to the local HA brands API (/api/brands/integration/{domain}/icon.png) when the icon is not available on \data-v2.hacs.xyz.

Environment

• HA version: 2026.3.2
• HACS version: 2.0.5
• Integration: ha-hi3510 (has \�rand/\ folder with icon.png and logo.png)

[hacs-bot]

Thank you for opening an issue in the HACS.

Before proceeding, please verify the following:

Select the correct issue template:
HACS provides different templates for different types of bugs. Choosing the right template ensures you're asked the right questions and helps route your bug appropriately.

Complete the ENTIRE issue template:
Make sure you've read the issue guidelines and filled out every single field in the issue template, even if some fields seem unrelated to your specific situation.

Fill out everything, even if it seems unnecessary:
Don't skip fields because they "don't seem relevant" to your bug. The template asks for specific information because:

• Problems often have unexpected causes that surface through "unrelated" details
• What seems unrelated to you might be the key to solving your bug
• Incomplete information requires follow-up questions, delaying resolution
• The template is designed based on years of troubleshooting experience
• Missing information forces those helping to make assumptions, which can lead to wrong solutions

Issues with incomplete templates take significantly longer to resolve or may be closed without resolution.

If you're experiencing a similar bug:
If your bug is identical to an existing one, please:

• Add a 👍 reaction to the original issue description
• Subscribe to notifications on that issue to stay updated
• Do not add comments like "same here", "I have this too", or "+1"

Adding duplicate comments creates noise and makes it harder to track and resolve issues. Reactions help prioritize issues based on how many users are affected.

Getting help:
If you need assistance filling out the template or understanding your issue:

• Issue Guidelines - Detailed instructions for reporting issues
• HACS Discord - Community support and real-time help

What happens next:
Maintainers and community members will review your issue and may:

• Ask for additional information if the template is incomplete
• Provide a solution or workaround
• Label the issue appropriately for tracking
• Link it to related issues or pull requests

[wmostert76]

Me too, for my https://github.com/wmostert76/ha-app-zonnestroom-20 repo

[manuveli]

What a debug ride to find out, that it's probably a bug in HACS. I'm also facing the same issue with my integration: https://github.com/manuveli/git-ha-ppens

[manuveli]

#5228
hacs/frontend#937

Delivered integration and frontend fix for this, hope it gets merged soon.

[mosandlt]

+1 — hitting this with my Bosch Smart Home Camera integration today (HACS submission hacs/default#7247). Just shipped v10.6.2 with a brand/icon.png (the official Bosch Smart Camera app icon) and confirmed:

• ✅ HA Core's local proxy serves it correctly: curl /api/brands/integration/bosch_shc_camera/icon.png returns the bundled PNG.
• ✅ Settings → Devices & Services shows the right icon.
• ❌ HACS dashboard / catalogue browse-view shows the gray "icon not available" placeholder (still hitting the legacy CDN path which auto-rejects new custom integrations since the Feb 2026 brands-proxy announcement).

Submitting a PR to home-assistant/brands custom_integrations/bosch_shc_camera/ was auto-closed (PR #10244) — the brands repo bot now refuses all custom-integration submissions and points users at the local-bundle mechanism. So there's no longer a workaround for new custom integrations; the HACS-dashboard gray placeholder is currently the only experience for any new integration entering HACS after Feb 25, 2026.

@manuveli's fix PRs (hacs/integration#5228 + hacs/frontend#937) look correct from a quick read — they switch to the same /api/brands/integration/{domain}/icon.png path that HA Core's frontend uses today. Would really help to get those merged. Happy to test against my integration once they land if useful.

[svilendotorg]

Confirming this affects HaSeerr as well:

• Repo: https://github.com/svilendotorg/haseerr
• Custom integration with brand/icon.png + brand/icon@2x.png at custom_components/haseerr/brand/
• Icon works correctly on HA Integrations page via /api/brands/integration/haseerr/icon.png
• Icon shows blank in HACS dashboard listing

Testing on HA 2026.4.4 + HACS 2.0.5.

[ArnaudFeld]

Hope it will working soon to see the icon of my custom integration (ha-sidebar-manager).

[Adya84]

same issue on 2 of mine, https://github.com/Adya84/ha-world-cup-2026, and https://github.com/Adya84/ha-football-hub

[simpleaddins]

same for mine: https://github.com/simpleaddins/HomeAssistantAICameraCentre

[lenucksi]

Mine is still very early alpha but I was able to verify the same https://github.com/lenucksi/rig-for-red