Image URL settings

XML

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

Screenshot

Images stored in separate Image nodes

XML snippet

<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:

Screenshot

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

Copy from here

Image URL: Items/ProductItem/ItemImage1

Image URL: Items/ProductItem/ItemImage2

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

Screenshot

URLs nested as the same named children of the Image node

XML snippet

<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>

You can extract them with the following settings:

Screenshot

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

Copy from here

Image URL: Items/ProductItem/ItemImages/ItemImage[1]

Image URL: Items/ProductItem/ItemImages/ItemImage[2]

Please note that the indexing of XML lists starts with 1.

JSON

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

Screenshot

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

JSON snippet

{
  "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:

Screenshot

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

Copy from here

Image URL: product_images[0].image

Image URL: product_images[1].image

Image URL: product_images[2].image

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.

Multiple image URLs in a single field/node/column

In some feeds, multiple image URLs may be stored in a single field, node, or column.

Sample feed with multiple image URLs stored in a single column

In such cases, use a Liquid formula together with multiple Image URL fields.

1. Use a Liquid formula to split the value into an array of URLs. Apply the split filter and specify a separator (in this case, a semicolon). Repeat this formula in each Image URL field in the Data Mapping section.

2. In each subsequent Image URL field, reference the next element from the array. Note that indexing starts from 0, regardless of the feed format.

{%- assign image_urls = Images | split: ";" %}{{ image_urls[0] }}

Screenshot

Image URL settings for extracting multiple URLs from a single node

Copy from here

Image URL:

{%- assign image_urls = Images | split: ";" %}{{ image_urls[0] }}

Image URL:

{%- assign image_urls = Images | split: ";" %}{{ image_urls[1] }}

Image URL:

{%- assign image_urls = Images | split: ";" %}{{ image_urls[2] }}

Image URL:

{%- assign image_urls = Images | split: ";" %}{{ image_urls[3] }}

Image URL:

{%- assign image_urls = Images | split: ";" %}{{ image_urls[4] }}