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

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>

You can extract them with the following settings:

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

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.

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.

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.

Example CSV feed showing multiple image URLs combined in one column separated by delimiters

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

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.
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] }}

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

PreviousDescription NextStatus

Last updated 2 months ago