Apple SF Symbols Icons for Home Assistant! (3000+ Icons)
- HACS tab > Menu > Custom Repository
- Paste this repo's URL
- Select Integration in the dropdown
- Install cupertino-icons from HACS
- Restart Home Assistant
- Home Assistant > Settings > Integrations > Add > Cupertino Icons > Install
The icons should be usable in Home Assistant now. If it doesnt show up, try refreshing the page, private browsing or restart Home Assistant.
- Copy
custom_components/cupertinointo your custom_components folder - Restart Home Assistant
- Home Assistant > Settings > Integrations > Add > Cupertino Icons > Install
The icons should be usable in Home Assistant now. If it doesnt show up, try refreshing the page, private browsing or restart Home Assistant
Prefix: ios
Eg: ios:lightbulb-fill | ios:cloud-moon-rain | ios:bed-double-fill
SF Symbols 3+ supports multi-color icons. This functionality has been ported into this repo to support multi-color icons in Home Assistant!
Just add Suffixes #color, #invert, #color-invert or #fullcolor to change the icon colors! (Credit to thomasloven for the inspiration)
Eg:
- ios:gear-badge-xmark#color
- ios:gear-badge-xmark#color-invert
- ios:gear-badge-xmark#fullcolor
You may download the MacOS App from Apple for a better reference.
Note: underscores(_) and dots(.) must be swapped with hipens(-)
Starting with v3.0+, this repo has been changed from a lovelace/frontend repo to a full-fledged integration. If you're upgrading from an older version:
- HACS > Uninstall "cupertino-icons"
- HACS > Menu > Custom Repository
- Delete this repo
- Follow Install instructions above
Copyrighted icons have not been exported and are not present in this repo. They will not be included.
- Brand Icons #29 (Fixes #15)
- Add support for SF Symbols 7 (Credit: @enzofrnt) #28
- Cleanup macOS spotlight files from repo
🎉 Thanks to all the contributors for v5.0!
- Fix version mismatch in manifest
- Add support for SF Symbols 6 (Credit: @HoussamOtarid)
- Fixed deprecation issue for HA 2025.7.0 (Credit: @lnlyssg)
🎉 Thanks to all the contributors for v4.0!
- Fixed a bug that caused sizing issues
- Fixed a bug that caused multi-color icons to be displayed incorrectly
- Update to SF Symbols 3.0
- Support for multicolor icons
- Supports icon picker
- Restructure and refactor layout
- Breaking Changes: Repo type has been changed from frontend/lovelace plugin to a full-fledged integration. You may need to uninstall, delete the repo from HACS and reinstall.