Adding variable images

• 1 minute to read

You may have pictures available online. To use them for variable data printing, you just need to provide URLs linking to those images. They must be accessible without any authorization. If, for some reason, you lose access to an image, for example, if it is deleted or is unavailable during the rendering process, then VDP may not work correctly.

As an alternative, you can host public images in your tenant's storage. This is useful when the images do not change from one order to another. For example, you can render logos based on user category, where one logo might be reserved for Silver users and another for Gold users. These image types never change, so you just upload them manually in the file manager, through an API, or after selecting them in a public gallery.

The third option is when these images can change from order to order, for example, photos of a person. Before you begin rendering, you will need to save the images in the same private storage as the template.

The endpoint POST /api/atoms/v1/designs/render-proof supports all these options, so you can use artwork from Asset Storage and external images through a link. In variableData, you can specify these sources as follows:

• A gallery of your artwork that you upload to the Assets > Images section:

  "image": "public:campaign-folder/certain-image.jpg"

• User images that they upload to their private storage:

  "image": "user:campaign-folder/certain-image.jpg"

• Images in an external system can be accessed through their URLs.

  "image": "https://example.com/certain-image.jpg"