# Custom icons

*Note: this feature is only available on paid plans.*

If you would like to use an icon that does not exist in Eraser's icon library in diagram-as-code, you can upload a custom icon.

## How to upload a custom icon

1. Open the [Custom Icons page](https://app.eraser.io/dashboard/all?settings=custom-icons) in Settings
2. Click on Upload SVG Icons and upload SVG files
3. Adjust the icon name as necessary.
   1. The icon name defined here will be used in diagram-as-code (e.g. `[icon: custom-icon-name]`

<Figure src="/assets/fb2c6f6-image.png" alt="" border />

Only SVG files are currently allowed as custom icons. Also, custom icons are shared across the entire team.

## How to use a custom icon in diagram-as-code

You can use a custom icon in diagram-as-code just as you would a regular icon and refer to it by the icon name.

For example, if `nasa` was the name of a custom icon you uploaded, you could write:

```eraser
Space shuttle [icon: nasa]
```

<Figure src="/assets/c5d5487-image.png" alt="" border />

## How to use a custom icon in AI diagrams

You can simply mention a custom icon by name in an AI prompt and Eraser AI will use it.

For example, if `nasa` was the name of a custom icon you uploaded, you could write the following prompt:

```eraser
Create a sequence diagram for a rocket launch sequence in communication with NASA
```

## How to insert a custom icon in the insert menu

If you'd like to use a custom icon outside of diagram-as-code, you can certainly do so as well. 

1. Open insert menu `/`
2. Go to Icon > Custom Icons
3. Select the custom icon you want to insert

<Figure src="/assets/9075b86-image.png" alt="" width="250px" border />