Skip to content

How to work with image variables

Feature Channel

Go to YouTube to see all feature videos

Create an Image Variable

The Basics

Create a variable, and change the type to "Image" (default will be Single-line text)

The Variable type dropdown open on the MyImage variable, with Image highlighted below Single-line text and Multi-line text

Optional: Choose a default image.

The DEFAULT STATE section with a chosen PNG default image shown as a thumbnail and filename, and a cross to clear it

Optional: set the variable to be required and add private data.

The GENERAL tab with Variable type set to Image, the Required toggle off, and PRIVATE DATA showing 0 key-value pairs added

User Interface Settings

In the User Interface settings, define the Label, Placeholder, Help text and Visibility.

The USER INTERFACE tab with Label MyImage, Help text Select an image, and the Visibility dropdown open on Always, Never and Conditional

Connector Settings

GraFx Media

The information below works for the (default) GraFx Media connector. For settings specific to another Media Connector, please consult the documentation page for this connector.

GraFx Media uses the concept of folders, other Media Connectors might use different terminology.

Set the path, where the end-user can browse for images.

The path can be fixed: Set Value or fed through a (text / list) variable having a path.

BROWSE OPTIONS on the GraFx Media connector, with Allow Browse on, the Folder set by value and Include subfolders on

Choose "Allow Upload" and set a path, to allow end-users to upload assets. We support 3 different types of assets: JPG, PNG, and TIFF.

Supported upload formats

Uploads are limited to three file formats: PNG, JPG and TIFF. This is not configurable.

For uploads, you can define a minimum width and height in pixels.

Once enabled, each uploaded file is stored in the "Upload/" folder (for the GraFx Media connector), or in a custom path you specify.
Uploaded assets become available just like any other image variable source.

UPLOAD OPTIONS with Allow Upload on, an upload folder set by value, and Min width 1920 px by Min height 1080 px

Assign image variable to image frame

Select the image frame you want to assign the template variable to.

In the variable tab, choose the image variable from the "Insert variable" drop-down menu.

You can also open the action menu of a variable (the 3 dots) and use the "Insert" option.

A selected image frame holding a garden still-life photo, with Insert variable set to MyImage in the Variables tab

Un-assign a template variable from an image frame

To remove the template variable from the image frame, select the frame and choose "None" from the "Insert variable" drop-down menu.

An empty crossed-through image frame, with the Insert variable dropdown open and None ticked above the image variable