---
url: https://plugin.stripo.email/editor-configuration/image-gallery.md
---
# Image Gallery

## Folders Configuration

You can access the image gallery when you or your users choose an image for the "Image" block. You independently decide how many folders it contains and whether the user can only use it as drag-and-drop or also upload images to it for future use.

For example, below you can see three folders in the image gallery named "Email", "Project", and "Common".

::: image-wrap
![](/img/plugin/new/image20.webp){width=450 height=298}
:::

These folders were created and configured on the Plugin details page as shown below.

::: image-wrap
![](/img/plugin/new/image21.webp){width=1476 height=1090}
:::

In this section, you can manage:

* **Number of folders:** Decide how many folders you need.
* **Folder names:** Specify the names of created folders in every supported language.
* **Folder path:** Define the path where images should be stored in each folder.
* **Permissions:** Grant respective permissions.

You can specify a dynamic folder path to the repository and insert variables that may be provided during the initialization of the Stripo editor.

For example, if you want to separate images for different email templates, you can create the "Emails" folder and specify its path as `${templateId}`. When initializing the Plugin, pass the `templateId` value (e.g., 00000) among the parameters in the `metadata`, and the Plugin will fetch images from the “00000” folder (this folder will be automatically created on the configured server if it does not exist yet).

:::success
Please be advised that by default, the Stripo plugin also creates technical folders to store generated banners, image previews for the “Video” basic block, etc. These folders cannot be managed from the Stripo Plugin details page.
:::

If you want to set the User role for a specific folder and prevent your clients from removing images, initialize the Plugin with the additional configuration:

```js
"hideDeleteImageAction": true
```

::: image-wrap
![](/img/plugin/new/image22.webp){width=400 height=444}
:::

This code hides the Delete option for images and leaves only the editing option for the User role.

::: image-wrap
![](/img/plugin/new/image23.webp){width=400 height=431}
:::

If you have any questions on this matter, please contact our support team at <support@stripo.email>.

## Upload Settings

Here you can specify the maximum size of an image uploaded to the gallery. The maximum value cannot exceed 20 MB per document.

Also you can activate the Image Compression control that helps to compress JPEG images for newly uploaded files.
You can set up the desired compression level for your JPEG files (Low/Medium/ High) - that corresponds to 75%, 55% and 30% accordingly.

Additionally, you can activate PNG Compression and add your API key from the TinePNG service. This service will automatically set up the suitable compression for the PNG images in order not to lose quality.

::: image-wrap
![](/img/plugin/new/image55.webp){width=1426 height=854}
:::

**Use Case**

This control is useful for reducing image file sizes, optimizing email load times, and ensuring better performance across different devices.

**How to Support**

Enable this feature in the plugin configuration settings. You can then specify the compression level for the images.

## Stock Image Configuration

If you want to provide your users with the option to search for and use free stock images within the image gallery while creating an email, simply activate the "Stock images configuration" option.

::: image-wrap
![](/img/plugin/new/image25.webp){width=1140 height=1066}
:::

Once activated, specify the stock folder name, choose an available stock images provider, and configure it according to the provided instructions.

The list of providers may be extended in the future.

## Using Custom Image Gallery via Extensions

If you want to replace Stripo’s default image gallery with your own image management system or media library, you can implement this via the Stripo **Extensions** framework.

When configured, your custom gallery will open instead of the default one whenever a user clicks to insert or edit an image. You are free to define your own UI, search, filtering, or upload logic — as long as it returns a valid image URL and alt text for insertion into the email.

**Availability:**\
This functionality is available starting from plugin version **2.21.0** and only for **Business** and **Enterprise** plans.

**Documentation:**

Please refer to [this guide](/extensions/core-concepts#external-image-library) to implement this feature.