> For the complete documentation index, see [llms.txt](https://docs.pentaho.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pentaho.com/pdia-admin/9.3-administer/embed-and-extend-pentaho-functionality-cp/embed-and-extend-pdi-functionality/extend-pentaho-data-integration/create-pdi-icons.md).

# Create PDI icons

This design guideline is intended to help you maintain consistency with other user interface elements within Pentaho Data Integration. It's recommended that you create your icon in vector shapes using a design tool which saves or exports to Scalable Vector Graphics (SVG) Version 1.1 format. Vector shapes allow assets to be scaled up without loss of detail and crisp edges.

**Note:** The W3C offers a [list of programs](http://www.w3.org/Graphics/SVG/WG/wiki/Implementations) that support SVG.

## The anatomy of a PDI icon

This section reviews the breakdown of what goes inside the icons.

| Icon                                                      | ID                                 | Description                         |
| --------------------------------------------------------- | ---------------------------------- | ----------------------------------- |
| <p><img src="/files/AD9Wjo25v7u8dRWyLta9" alt="icon"></p> | 1: Icon fill color                 | The primary stroke color is #3D6380 |
| 2: Icon border color                                      | The primary stroke is 1.7pt        |                                     |
| 3: Icon foreground line color                             | The secondary stroke size is 0.8pt |                                     |

## Positioning action indicators

| Icon                                                                               | ID                                                                                                                                    | Description                                                                                                                                              |
| ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><img src="/files/40LMeqWiOQD39pvbt4O2" alt="Positioning action indicators"></p> | 1: Action indicator                                                                                                                   | For any PDI icon which requires an action indicator, the icon must have the secondary element placed in the top-left or bottom-right corner of the icon. |
| 2: Forty-five degree slice for positioning action indicators                       | The primary element within the icon is recommended to have a 45º angle sliced through, and the secondary element placed in that spot. |                                                                                                                                                          |

### Action indicator badges

| Icon                                                                     | Description                                     | Icon                                                                   | Description                                                 | Icon                                                                     | Description              |
| ------------------------------------------------------------------------ | ----------------------------------------------- | ---------------------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------ | ------------------------ |
| <p><img src="/files/7PHYZ002DiZlCJcufv8s" alt="input indicator"></p>     | Input / Import /Get / Download / Extract / Read | <p><img src="/files/lSFf1dHDbI7pCZ6IzDtp" alt="output indicator"></p>  | <p>Output / Upload /Export / Insert /</p><p>Put / Write</p> | <p><img src="/files/sgRvmJFdBQxfsOmmNvdU" alt="validated indicator"></p> | Validate                 |
| <p><img src="/files/EIsx0qWAHmpZtbreGZdz" alt="create indicator"></p>    | Create                                          | <p><img src="/files/BlJ7s5Qqru2UMsdzIen7" alt="compare indicator"></p> | Compare                                                     | <p><img src="/files/3v1rfSwrVvbkknV1CLmG" alt="wait indicator"></p>      | Wait                     |
| <p><img src="/files/tPcuoZG62PcXStFLg86H" alt="block indicator"></p>     | Block                                           | <p><img src="/files/2yEoDK9ibRlhi7I4cI1P" alt="execute indicator"></p> | Execute / Call                                              | <p><img src="/files/6eyA0pbujabx3n1RMvNN" alt="search indicator"></p>    | Search / Lookup / Exists |
| <p><img src="/files/2PeZY5k3oOs1nDYT5Fpf" alt="bulk load indicator"></p> | Bulk Load                                       | <p><img src="/files/8Pp3CCze5FVxqL8UtTID" alt="encrypt indicator"></p> | Encrypt                                                     | <p><img src="/files/oZC2QubZb00NWdQYzg45" alt="generator indicator"></p> | Generator /Processor     |
| <p><img src="/files/zh0VCGA5Fwz8diwOGkC7" alt="delete indicator"></p>    | Delete                                          | <p><img src="/files/IaisoYwZNpTtlYRDPK9j" alt="decrypt indicator"></p> | Decrypt                                                     | <p><img src="/files/Zr65SA3oZnmmXbLV8xfy" alt="upsert indicator"></p>    | Upsert                   |
| <p><img src="/files/e5B57qJaYMWmEby9GbTg" alt="update indicator"></p>    | Update                                          | <p><img src="/files/4onKICuIBBjQHD7ysEPv" alt="move indicator"></p>    | Move                                                        | <p><img src="/files/dCDG1EWd1C9PNeidkBXp" alt="set indicator"></p>       | Set                      |

## Color palette

![Shades of blue in the color palette](/files/CnYxSjmGbUBkQl2Jp7BV)

![Color palette for icons](/files/aFJsIkCrNTIJAq57lK8M)

## Downloading PDI icon template

You can use the SVG template file, `PDI_Icon_Guide.ai`, as a starting point for creating a PDI icon. This file is bundled with the other samples in the Pentaho Data Integration SDK. You can download the SDK from the [Support Portal](https://support.pentaho.com/home).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pentaho.com/pdia-admin/9.3-administer/embed-and-extend-pentaho-functionality-cp/embed-and-extend-pdi-functionality/extend-pentaho-data-integration/create-pdi-icons.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.