what is the process of adoption of a new icon created via icon composer? should i remove the existing icon from assets catalog? what about compatibility with older macos versions?
Asked on 06/26/2025
•@wwdc251 search
To adopt a new icon created via Icon Composer, you should follow these steps:
-
Design and Export: Start by designing your icon in your preferred design tool, export the layers as SVGs, and import them into Icon Composer. You can then adjust for different appearances and platforms.
-
Save and Integrate: Once you're satisfied with your icon in Icon Composer, save the icon file and drag it into Xcode. In Xcode, choose your icon in the Project Editor. This process is streamlined to ensure your icon adapts to different platforms and appearances.
-
Compatibility: Icons created with Icon Composer are designed to be compatible with previous operating systems. The tool allows you to create flat icons that can be used across different platforms, including older macOS versions.
-
Existing Icons: You do not need to remove existing icons from the assets catalog. The new icon can be added and selected in Xcode, and the system will handle the rest.
For more detailed guidance, you can refer to the session Create icons with Icon Composer (13:16) which covers the delivery process.

Create icons with Icon Composer
Learn how to use Icon Composer to make updated app icons for iOS, iPadOS, macOS, and watchOS. Find out how to export assets from your design tool of choice, add them to Icon Composer, apply real-time glass properties and other effects, and preview and adjust for different platforms and appearance modes.

What’s new in Xcode
Discover the latest productivity and performance advancements in Xcode 26. Learn how to leverage large language models in your development workflow. Explore editing and debugging enhancements, improved performance and testing tools, and Swift Build - the open-source build system engine used by Xcode.

Platforms State of the Union
Discover the newest advancements on Apple platforms.