Home Assistant Cupertino Icons (SF Symbols)

Apple SF Symbols Icons for Home Assistant! (3000+ Icons)

                       
                       

Install

HACS (Recommended)

1. HACS tab > Menu > Custom Repository
2. Paste this repo's URL
3. Select Integration in the dropdown
4. Install cupertino-icons from HACS
5. Restart Home Assistant
6. 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.

Manual

1. Copy custom_components/cupertino into your custom_components folder
2. Restart Home Assistant
3. 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

Usage

Prefix: ios
Eg: ios:lightbulb-fill | ios:cloud-moon-rain | ios:bed-double-fill

Multi-Color Icons

                       
                       

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

Icon Reference

SF Symbols | Apple

You may download the MacOS App from Apple for a better reference.

Note: underscores(_) and dots(.) must be swapped with hipens(-)

Breaking Changes

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:

1. HACS > Uninstall "cupertino-icons"
2. HACS > Menu > Custom Repository
3. Delete this repo
4. Follow Install instructions above

Legal Disclaimer

Copyrighted icons have not been exported and are not present in this repo. They will not be included.

Changelog

v5.0.1

• Brand Icons #29 (Fixes #15)

v5.0.0

• Add support for SF Symbols 7 (Credit: @enzofrnt) #28
• Cleanup macOS spotlight files from repo

🎉 Thanks to all the contributors for v5.0!

v4.0.1

• Fix version mismatch in manifest

v4.0.0

• 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!

v3.0.2

• Fixed a bug that caused sizing issues

v3.0.1

• Fixed a bug that caused multi-color icons to be displayed incorrectly

v3.0

• 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.