---
title: "Uploading Custom Images"
slug: "uploading-custom-images"
tags: ["Decisions Studio", "Custom Images", "Look and Feel"]
updated: 2026-02-11T14:36:50Z
published: 2026-02-11T14:36:50Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Uploading Custom Images

## Overview

Users may submit custom images into the **Decisions Image Library**, where they may be [added to Forms, Pages, etc](/v9/docs/adding-an-image-to-a-pagedashboard)., to suit aesthetics and/or branding needs best.

Using the **Custom Images** folder helps improve performance for icons and other UI elements that are reused across Forms, Pages, Dashboards, and similar surfaces. Images stored in the instance Image Library can be served consistently within the platform, reducing repeated lookups and minimizing reliance on external image locations.

Uploading an image in the Decisions memory allows multiple users in the same instance to quickly access similar images, such as logos and icons, when creating an Element. This removes the repetitive rework of selecting the same image URL and/or image file from a device.

Custom images support the following image file extensions.

- SVG
- ICO
- JPG / JPEG
- PNG

There are two ways to add Custom Images to Decisions: the System folder or the File Directory.

Note:From the uploaded custom images, Decisions [default image library](https://documentation.decisions.com/v9/docs/adding-an-image-to-a-pagedashboard?highlight=default%20Image%20Library) will only display the .svg format that can be used in Forms, Pages, Dashboards, etc.  
![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1689776900987.png)

---

## System Folder

1. Navigate to **System > Designers > Images > Custom Images.**
2. Select ADD at the top left of the Custom Images folder.  
![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-07-31_09h55_26.png)
3. In the Add window, drag or choose a supported image file to upload, then confirm the selection by choosing UPLOAD IMAGE. Refresh the browser to view the newly uploaded image in the folder.  
![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-14_16h09_36.png)

---

## Using a Custom Image in a Form

After a custom image is uploaded, it can be referenced from a Form by selecting it as a constant input on a Show Form step.

1. Create a new [Flow](/v9/docs/create-flows) in a Designer Project.
2. Add a **Show Form** step, then select the step and choose **Pick or Create Form**.
3. In the picker, select **Create New Form** to open the Form Designer.
4. In the Form Designer, drag an **Image** control onto the Form.
5. Select the Image control, set a **Data Name** (for example, **Car Image**), and enable the following properties:
  - **Show No Icon When Image Missing**
  - **Use Image Info as Input**
6. Save and close the Form.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1770663261140.png)
7. Back in the Flow Designer, select the **Show Form** step and locate the Image input (for example, **Car Image**).
8. For the Image input, set the mapping type to **Constant**, then select the **Edit** (pencil) icon to open the **Pick Image** window.
9. In the **Pick Image** window, select **Custom Images**, choose an uploaded image, and select **Pick** to confirm.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1770663476749.png)
10. Save the Flow and run **Debug** to confirm the image renders in the Form.

---

## Deleting a Custom Image

1. Navigate to **System > Designers > Images > Custom Images**.
2. Right-click the image, then select **Delete**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1770663907650.png)