Skip to main content

Add the Image Exporter export

Add the Productsup Image Exporter export.

Introduction

The Image Exporter lets you save the images from your feeds, located under the image URLs, as physical files hosted on Amazon S3, Microsoft Azure Blob Storage, or an FTP/SFTP server. You can either save them as individual images or in a ZIP file.

The Image Exporter sends deltas, updates only, rather than the entire data feed to the destination.

  • The Image Exporter only sends new and modified IDs or SKUs. If you delete an ID or SKU from the feed, you are not removing it from the destination where you are exporting the images.

  • The Image Exporter uses the same logic whether or not you are using a ZIP file. The ZIP file approach packages the images together in a ZIP file rather than individually.

Requirements

  • To upload your images to Amazon S3, you must log in or create an Amazon Web Service (AWS) account. See AWS.

  • To upload your images to Azure Blob Storage, you must log in or create a Microsoft Azure account. See Azure.

  • To upload your images to an FTP/SFTP, you must provide FTP/SFTP credentials that allow write access.

Add the Image Exporter export to your site

  1. Go to Exports A/B from your site's main menu and select ADD EXPORT.

  2. Choose Image Exporter and select Add. Select Add again to confirm your selection.

add_image_exporter.png

Set up the Dataflow

You can export several images per product. Each image needs a URL and a filename for saving on S3. The required columns are:

  • id: Your unique product identifier. This ID is critical for sending delta files.

  • img_url_{ascending_number}: The image source URL.

  • img_name_{ascending_number}: The image file name, including the file extension.

If you want to export only one image per product, go to Dataflow and map the id, image_name_1, and image_url_1 columns as appropriate.

If your items have more than one image you want to upload, map the id column and as many image_name and image_url columns as necessary.

Important

To prevent you from overwriting your images, make sure not to use duplicate image names within your feed.

dataflow.jpg

Configuring destinations

All destinations share the following four (4) standard settings:

  • Concurrency: This determines the maximum number of simultaneous image downloads.

    Important

    For best results, set your concurrency between 10-20 if you have more than 1,000 items.

  • Download Progress Notification Interval: Enter the number of downloads for exceeding a limit set by you to determine when a download progress notification appears.

  • Zip file (optional): When you enter a filename, the platform compresses all images before uploading.

  • Zip Size Limit: Enter a maximum ZIP file size in bytes, as necessary. If you reach the size limit, export your images using several ZIP files.

Configure the S3 Destination

  1. Return to Exports A/B and select the Setup icon from the Image Exporter export. Select Add Destination, choose Image Exporter (AWS S3) / subprocess, and identify your destination in Name.

    destination_amazon.png
  2. Enter your AWS credentials in Access Key ID and Secret Access Key, then choose your S3 location in Region.

  3. Lastly, enter the bucket name for your image uploads in Bucket, and define the image path in Base Path.

    image_exporter_aws.png

Configure the Blob Storage destination

  1. Return to Exports A/B and select the Setup icon from the Image Exporter export. Select Add Destination, choose Image Exporter (Microsoft Azure), and identify your destination in Name.

    destination_azure.png
  2. Enter your Microsoft Azure credentials in Account Name and Access Key.

  3. Lastly, enter the container name for your image uploads in Blob Container, and define the image path in Base Path.

    image_exporter_azure.png

Configure the FTP/SFTP destination

  1. Return to Exports A/B and select the Setup icon from the Image Exporter export. Select Add Destination, choose Image Exporter (FTP or SFTP), and identify your destination in Name.

    destination_ftp.png
  2. Enter your FTP server address in FTP Hostname. Then, enter the credentials in FTP Username and FTP Password.

  3. Define the image path in Base Path.

    image_exporter_ftp.png