Image URL settings

XML

You may encounter an XML structure where links to images are stored in separate Image nodes.

Images stored in separate Image nodes annotated

<Product>
  <Items>
    <ProductItem>
      <ItemCode>A012345</ItemCode>
      <ItemImage1>http://warehouse.com/images/A012345.jpg</ItemImage1>
      <ItemImage2>http://warehouse.com/images/A012345_1.jpg</ItemImage2>
    </ProductItem>
  </Items>
</Product>

For the notation above, use the following settings in the Image URL fields:

Stockeo settings for Image URL fields when images are stored in separate ItemImage nodes annotated

It may also happen that the URLs are nested as children of the Image node.

Images stored in the child nodes of ItemImages node annotated

<Product>
  <Items>
    <ProductItem>
      <ItemCode>A012345</ItemCode>
      <ItemImages xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d5p1:string>http://warehouse.com/images/A012345.jpg</d5p1:string>
        <d5p1:string>http://warehouse.com/images/A012345_1.jpg</d5p1:string>
      </ItemImages>
    </ProductItem>
  </Items>
</Product>

Use the following settings to access them:

Stockeo settings for Image URL fields when images are stored in in the child nodes of ItemImage node annotated

Another case is when the URLs are nested as the same named children of the Image node.

URLs are nested as the same named children of the Image node annotated

<Product>
  <Items>
    <ProductItem>
      <ItemCode>A012345</ItemCode>
      <ItemImages>
        <ItemImage>http://warehouse.com/images/A012345.jpg</ItemImage>
        <ItemImage>http://warehouse.com/images/A012345_1.jpg</ItemImage>
      </ItemImages>
    </ProductItem>
  </Items>
</Product>

Get accees to them with these settings:

Stockeo settings when URLs are nested as the same named children of the Image node annotated

JSON

In the JSON file images may be stored as an array of objects that consist of e.g. image id and image URL.

Image URLs are stored as a property of the object in the product_images array annotated

{
  "data": [
    {
      "product_code": "A012345",
      "product_name": "Sitting Jazz Band Strings",
      "product_images": [
        {
          "id": 5856,
          "image": "https://warehouse.com/images/A012345.jpeg"
        },
        {
          "id": 5857,
          "image": "https://warehouse.com/images/A012345_1.jpeg"
        }
      ]
    }
  ]
}

In this case use the following settings:

Stockeo settings when Image URLs are stored as a property of the object in the product_images array annotated

Please note that the indexing of array elements in JSON starts at 0.

You can add fields up to the highest expected number of images. This will not cause an error, even if there is no link to the image on the given index.

PreviousQuantity format NextVariants

Last updated 2 years ago