Skip to content

Import Products Images to Magento

This task imports product images into Magento, creating images which don't exist and updating those that already exist.

The input file should be in Magento XML format. The images are matched based on file name first, and then label.

Settings

Connection

Required
The Magento connection to use. See the Connecting to Magento v1 article if you require more information on how to create/manage connections.

Fail File

Required
An absolute or relative file path on the local computer or network to save records that fail to import to Magento.

See the Zynk Objects article if you require more information on how the Zynk Object file value works.

Defaulted to magento_import_product_images_fail.xml in the current working directory.

Input File

Required
The absolute or relative file path to the XML file containing the Magento product images to import.
This can also be inline XML, e.g. by generating the data using a razor script or by providing a URI to a script generating the data and specifying 'Read contents of file'.

See the Zynk Objects article if you require more information on how the Zynk Object file value works.

Defaulted to Output from the previous task

Success File

Required
An absolute or relative file path on the local computer or network to save records that are successfully imported to Magento.

See the Zynk Objects article if you require more information on how the Zynk Object file value works.

Defaulted to magento_import_product_images_success.xml in the current working directory.

Prevent Reprocessing

Required
Set to true if you would only like to import each image to Magento the first time it is processed by Zynk.

This setting relies on the <external_id> element being provided in the product image XML data.

Defaulted to False.

Zynk Settings

See Common Task Settings.

Examples

A sample input file is shown below. The images themselves are contained in the content element, and are base 64 encoded.

<?xml version="1.0"?>
<ArrayOfProductMedia xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <ProductMedia>
    <sku>TEST001</sku>
    <data>
      <ProductImage>
        <label>test image</label>
        <file>
          <content>/9j/4AAQSkZJRgABAQEAYABgAAD/4QAiRXhpZgAATU0AKgAAAAgAAQESAAMAAAABAAEAAAAAAAD/2wBDAAIBAQIBAQICAgICAgICAwUDAwMDAwYEBAMFBwYHBwcGBwcICQsJCAgKCAcHCg0KCgsMDAwMBwkODw0MDgsMDAz/2wBDAQICAgMDAwYDAwYMCAcIDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAz/wAARCAAQABADASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL/8QAtREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcRMiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP09fb3+Pn6/9oADAMBAAIRAxEAPwD41/Zb+Gvw7+KPie703x74u8VeF5JvJh0mPQvDf9tz6jcSPt8ry/OjKnlduM7i2OK6X/gob+y94Q/Y6+P8/gHwv4zv/Gt5o9tH/bVxPp0dktheONxtAEllDPGpUOd2FcleqmrP/BOP9pXwH+yP8fU8eeNPDGueKLzRrV/7Bi065gh+wXrgqLtvOV1Z4lJMYKkByGP3QK5P9qfxl8MPHXiOz1D4c6V8QtPmujPPrU/izWrfVLi9uHcMJFeGKPBOXLFsklgeOc/h/wC5+p9Oe/ne35a/gl5n+p3Nmb4jt+8+rKHan7Nzfnb2iUUu75pT6KOv/9k=</content>
          <mime>image/jpeg</mime>
          <name>test image</name>
        </file>
        <types>
          <string>image</string>
          <string>small_image</string>
          <string>thumbnail</string>
        </types>
      </ProductImage>
      <ProductImage>
        <label>test image 2</label>
        <file>
          <content>/9j/4AAQSkZJRgABAQEAYABgAAD/4QAiRXhpZgAATU0AKgAAAAgAAQESAAMAAAABAAEAAAAAAAD/2wBDAAIBAQIBAQICAgICAgICAwUDAwMDAwYEBAMFBwYHBwcGBwcICQsJCAgKCAcHCg0KCgsMDAwMBwkODw0MDgsMDAz/2wBDAQICAgMDAwYDAwYMCAcIDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAz/wAARCAAQABADASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL/8QAtREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcRMiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP09fb3+Pn6/9oADAMBAAIRAxEAPwD41/Zb+Gvw7+KPie703x74u8VeF5JvJh0mPQvDf9tz6jcSPt8ry/OjKnlduM7i2OK6X/gob+y94Q/Y6+P8/gHwv4zv/Gt5o9tH/bVxPp0dktheONxtAEllDPGpUOd2FcleqmrP/BOP9pXwH+yP8fU8eeNPDGueKLzRrV/7Bi065gh+wXrgqLtvOV1Z4lJMYKkByGP3QK5P9qfxl8MPHXiOz1D4c6V8QtPmujPPrU/izWrfVLi9uHcMJFeGKPBOXLFsklgeOc/h/wC5+p9Oe/ne35a/gl5n+p3Nmb4jt+8+rKHan7Nzfnb2iUUu75pT6KOv/9k=</content>
          <mime>image/jpeg</mime>
          <name>test image 2</name>
        </file>
        <types>
          <string>image</string>
          <string>small_image</string>
          <string>thumbnail</string>
        </types>
      </ProductImage>
    </data>
  </ProductMedia>
</ArrayOfProductMedia>