Create and use SVG icon libraries

POM Theme has two related icon areas:

• Design system → Icons manages custom SVG libraries.
• Design system → Brand → Default icons selects shared icons for theme actions.

Create a library

1. Open Icons.
2. Under SVG Icon Libraries, enter a Library title.
3. Select Add library.
4. In the new library card, select Upload SVGs.
5. Choose one or more standalone .svg files.
6. Confirm that each icon appears with the expected filename.

The library receives a slug and becomes available to compatible icon pickers.

Prepare SVG files

Use trusted, purpose-built icons with a suitable viewBox. Keep filenames descriptive and unique within the library. Remove unnecessary embedded metadata and verify that the icon remains recognizable at the small size used by controls.

Do not upload an SVG from an untrusted source without reviewing it.

Select shared interface icons

Under Brand → Default icons, POM provides selectors for actions such as telephone, email, address, login, share, search, menu, close, play, pause, download, cart, sliders, social sharing, and accordion states.

Changing one of these settings affects theme output that consumes that shared icon. Review every relevant context after saving.

Delete carefully

The manager can delete an individual SVG or an entire library. Before deletion:

1. replace every selection that uses the icon or library;
2. save the affected settings or components;
3. verify the public output;
4. delete only the unused asset.

Deleting a library is not equivalent to hiding it and can leave existing selections without their intended icon.

Accessibility review

An icon that communicates an action needs an understandable accessible name from its surrounding link or button. Decorative icons should not repeat adjacent text. Never rely on an icon's shape or color alone to communicate an error or destructive action.