Our app makes it easy to prepare and organise product images automatically. Here's what you need to do:

1. Upload Your Images

Upload your product images to the product-images container in the dlsproductimginprod001 storage account.

Both PNG and JPEG file types are supported.

You should name your images like this...

{itemId}-{colour}-{displayOrder}.{fileExtension}

For example...

203595-Seamist-02.jpeg

The app supports images with 4:3 and 1:1 (square) aspect ratios.

If you have images with these specific aspect ratios (4:3 or 1:1 square), use this naming convention...

{itemId}-{colour}-{displayOrder}_{aspectRatio}.{fileExtension}

For example...

203595-Seamist-02_43.jpeg
203595-Seamist-02_11.jpeg

Tip: The app is not case-sensitive, so uppercase/lowercase doesn't matter.

2. Process Your Images

When you're ready, click Organise Product Images in the app.

The app will automatically clone, rename and save your images as both JPEG and PNG.

If the app successfully processes an image without error, it will be deleted from dlsproductimginprod001/product-images. If the app experiences an error when processing an image, it will not be deleted.

The app automatically keeps a log of all actions, so you can easily see which images were processed successfully and which had issues. If there are errors, you can download the full log as a CSV file by clicking the icon in the row of the table.

The app has 6 statuses to indicate how your image processing job went:

• Queued: Job is waiting to be processed
• Running: Job is actively being processed
• Succeeded: All images processed without any errors
• Partially Succeeded: Some images processed successfully, others had errors
• Failed: No images were processed successfully or fatal error occurred
• Unknown: Status cannot be determined or fatal error occurred

You can click the Refresh Table button to get the latest status.

Practical Examples

• Example 1: Complete Success
  • 10 images uploaded, all process successfully
  • All 10 images deleted from input storage
  • Final Status: "Succeeded"
• Example 2: Partial Success
  • 10 images uploaded, 7 process successfully, 3 have errors
  • Only the 7 successful images are deleted from input storage
  • 3 problematic images remain for manual review
  • Final Status: "Partially Succeeded"
• Example 3: Complete Failure
  • 10 images uploaded, all have validation errors or processing failures
  • No images are deleted from input storage
  • Final Status: "Failed"

3. Where Your Images Go

After processing, the output images are organised into several output locations:

Standard Images

• JPEG: dlsproductimgoutprod001/product-images/jpeg/{itemId}/{colour}/{itemId}-{colour}-{displayOrder}.jpeg
• PNG: dlsproductimgoutprod001/product-images/png/{itemId}/{colour}/{itemId}-{colour}-{displayOrder}.png

Web Select (private):

• JPEG: dlsproductimgoutprod001/product-images-webselect/jpeg/{itemId}-{colour}-{displayOrder}.jpeg
• PNG: dlsproductimgoutprod001/product-images-webselect/png/{itemId}-{colour}-{displayOrder}.png

POS images:

• JPEG: dlsproductimgoutprod001/product-images-pos/jpeg/{itemId}-{colour}-{size}_000_-{paddedDisplayOrder}.jpeg
• PNG: dlsproductimgoutprod001/product-images-pos/png/{itemId}-{colour}-{size}_000_-{paddedDisplayOrder}.png

SANA storage:

• SANAs storage account/6762-scctg2qld5ib4w-content/content/files/images/productimages/{itemId}-{inventDimId}-{displayOrder}.jpeg

4:3 Aspect Ratio Images

• JPEG: dlsproductimgoutprod001/product-images-43/jpeg/{itemId}/{colour}/{itemId}-{colour}-{displayOrder}.jpeg
• PNG: dlsproductimgoutprod001/product-images-43/png/{itemId}/{colour}/{itemId}-{colour}-{displayOrder}.png

1:1 Aspect Ratio Images (Square)

• JPEG: dlsproductimgoutprod001/product-images-11/jpeg/{itemId}/{colour}/{itemId}-{colour}-{displayOrder}.jpeg
• PNG: dlsproductimgoutprod001/product-images-11/png/{itemId}/{colour}/{itemId}-{colour}-{displayOrder}.png

Notes:

• All containers in dlsproductimgoutprod001 are public except product-images-webselect, which is private.
• The SANA storage account does not sit in our Tenant, it sits in SANA's.
• When contacting support please quote the Invocation Id or attach the CSV file created when you click the Export Table button.
• Logs and invocations are automatically deleted after 30 days.