Home Assistant Cupertino Icons (SF Symbols)

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

Install

HACS (Recommended)

• 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 doesn't show up, try refreshing the page, using private browsing, or restarting Home Assistant.

Manual

• Copy custom_components/cupertino into 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 doesn't show up, try refreshing the page, using private browsing, or restarting 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 the 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 hyphens(-)

Breaking Changes

Starting with v3.0+, this repo has 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 the 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.

--- Tranlated By Open Ai Tx | Last indexed: 2026-03-16 ---