This topic describes how to add and manage custom third-party icon libraries. You can add links from your custom iconfont projects to use more flexible and diverse icons for your components.
Add an icon library
The platform supports icon resources from iconfont projects. You can maintain your icon libraries on the iconfont website and then add the JS link for the library to the platform.
1. Copy the iconfont project JS link
On the iconfont website, navigate to Resource Management > My Projects > Symbol > View Online Link. The JS link for the project library is displayed. Copy the link.
2. Add the JS link to the platform
Navigate to Settings, select Icon Library, and then click Add.
Enter a name and the URL for the icon library. Click Add. The application automatically refreshes to activate the new icon library.
Using icons
After you add an icon library, it becomes available in all locations where you can set component icons. For example, to set a custom icon for a button, you can go to the Select Icon tab and select your added library.
Ant Design is the platform's default icon library. Do not name your third-party icon library 'Ant Design'.
Edit or delete an icon library
Navigate to Settings > Icon Library to view and manage your added third-party icon libraries. You can edit a library's name or URL. Only delete a library when you are sure it is no longer in use.
Before you delete an icon library, confirm that no components are using it. If you delete a library that is in use, its icons will not display correctly on components. An icon-related error appears in the error checker in the bottom-left corner of the platform. You can use this error to find the affected component. Then, you can remove the broken icon or replace it with a new one.
If you accidentally delete an icon library, you can press Ctrl+Z (Windows) or ⌘+Z (Mac) to undo the action.
Considerations
URL format: Ensure that the imported library uses the URL format provided by iconfont projects.
Performance: Third-party icon libraries can increase application load times. The platform supports a maximum of five icon libraries.
License and compliance: You must maintain your icons in iconfont. Ensure that you understand and comply with the license terms, including icon copyrights.