Custom SVG Library: Upload and Manage Reusable Icons

IOTA includes a large built-in icon library, but for use cases that require custom icons, the Custom SVG Library provides a way to upload and centrally manage your own SVG icons.

This is ideal for company-specific icons or visuals tailored to a particular domain or equipment type—ensuring consistency and simplifying reuse across multiple views.

1. Open the Custom SVG Library

Navigate to the Tools tab in the left-hand menu and select Custom SVG Library.

Open Custom SVG Library

2. Create a New Library

1. Click the ➕ (plus) icon to create a new library.
2. Enter a name and an optional description in the popup that appears.
3. Click Apply to create the library.

Create New Custom SVG Library

3. Upload Custom SVGs

1. Click the upload icon.

Upload SVGs

2. In the popup, select Choose Component.
3. Choose one or more .svg files from your computer.

4. Review and Finalize Upload

The selected icons appear in the popup preview window.

Select Icons

1. Use Select All or manually choose which icons to upload.
2. Click Apply to complete the upload.

Once uploaded, the icons will be listed in your custom library.

Uploaded Icons

5. Use Icons in a View

Icons in the custom library can be added to views via drag & drop, just like standard components.
To configure visual settings such as size or color, refer to the guide here: Configuring SVG Visuals.

6. Edit the Name or Description

To update the library’s name or description, click the edit (pen) icon at the top of the library view.

7. Delete Icons or the Entire Library

To remove an individual icon, click the trash icon next to it.
To delete the entire library, use the trash icon at the top of the library view.

Deleting Icons and Library

Note:

The library can only be deleted once all icons have been removed.

One-Time Use Icons

To insert a single SVG into a view without saving it to a library, refer to the Complex Components section.