What is Multiple Uploads?

Photo Upload now comes in two types: Single Upload (the original behavior) and Multiple Uploads, which lets your buyers upload more than one photo in a single field.

Multiple Uploads has 2 output types.:

• Single Output uses a GenAI effect to combine all uploaded photos into one final image, for example, merging photos of the same person at different ages, or combining several family members into one design.
• Multiple Outputs doesn't apply any effect: each uploaded photo is placed into its own Photo Upload layer on the design, which is perfect for photo collages, photo books and other multi-photo layouts.

Behavior on the Storefront

Single Output

Buyers tap the + button to upload photos, either several at once or one by one. Unlike Single Upload, the + button stays visible so they can keep adding more photos. They can remove (X) or drag to reorder the photos, then click Generate image and wait for the AI service to return the combined image.

Multiple Outputs

• Buyers tap on the + button to upload photos: select several at once or one by one, up to the Maximum photos you set.
• There is no Generate image button. Photos are uploaded right away and appear on the live preview immediately, each one in its own spot: photo #1 goes to the layer set to {{input.1}}, photo #2 to {{input.2}}, and so on.
• Buyers can remove (X) or drag-reorder the thumbnails. Reordering moves the photos to the matching spots on the design.
• If buyers upload fewer photos than the number of spots, the empty spots keep their placeholder.
• The field is required: Add to Cart is only allowed once at least one photo is uploaded and every selected photo has finished uploading.
• The Multiple Uploads layer itself is not shown on the design, mockup or print file, the photos only appear through the Photo Upload layers that receive them.

How to set up a Multiple Uploads layer

• Open an Artwork (only in Artwork 2.0), select Photo Upload in the layer picker, then choose Multiple Uploads.

• Choose an Output Type: Single Output or Multiple Outputs. The available settings depend on this choice.

Settings for Single Output

• Maximum photos: how many photos a buyer can upload, up to a limit of 3 (GenAI services work best with 3 or fewer input images).
• Upload editor: Direct Upload or Photo Reposition. Photo Cropper is not supported for Multiple Uploads.
• GenAI service: the AI provider (OpenAI, Gemini, Flux...). This is required for this layer.
• Set minimum size: same as Single Upload, but applies to every photo the buyer uploads, not just one.
• Fit mode, Show customer's photo on live preview and Add instruction for customer: work the same as in Single Upload.

You can translate the Generate image button in Product Page Content → Generate Image Buttons.

Settings for Multiple Outputs

• Maximum photos: at least 2, with no upper limit
• Upload editor: Direct Upload or Photo Reposition (Photo Cropper is not supported)

Add a Photo Upload layer for each photo

Multiple Outputs only collects the photos. To show them on the design, add one Photo Upload layer for every photo and link it to the Multiple Uploads layer:

• Add a Photo Upload → Single Upload layer and place/resize it where photo #1 should appear.
• In Personalization for this layer, choose No personalization so buyers only see the Multiple Uploads field on the form.
• Open POPULATE VALUES and turn on Populate Content from another option. Select your Multiple Uploads layer as the Source option, then click + Available Value and choose {{input.1}} (original photo #1).
• Repeat for the next spots with {{input.2}}, {{input.3}}... Tip: duplicate the first layer, move it, then just change the value.

Notes

• With Multiple Outputs, only {{input.1}}, {{input.2}}... are offered; {{output}} (the combined image) is only available for Single Output.
• Teeinblue doesn't check whether the number of Photo Upload layers matches Maximum photos, so make sure you add one layer for each photo you want to show.
• Each photo uses the fit mode of the Photo Upload layer it is placed into, and if that layer has its own image effect (e.g. a GenAI filter or Remove background), the effect is applied to that photo too.
• If you switch an existing Single Output layer to Multiple Outputs, any Photo Upload layer still set to {{output}} loses its populate setting when you save the artwork. Re-select {{input.N}} for those layers.

Photo Reposition with Multiple Outputs

• When Upload editor is set to Photo Reposition, buyers see a Recustomize image button on the Multiple Uploads field after uploading. It opens a popup where they can adjust the position of each photo and switch between the photo spots. The button only shows when at least one of the layers below holds a photo, and is disabled while a photo is still uploading or an effect is running.

• The popup positions the Photo Upload layers set to No personalization (by default, the whole photo fits inside the frame), plus any layer that has its own Photo Reposition editor (both share the same position). Photo Upload layers personalized with Direct upload or Photo Cropper keep working with their own editor and are not listed in the popup.

Updated on: 10/11/2026