How to add Product Images

Xada provides flexible tools for managing product images, whether products are synced from a supplier feed or created and managed manually. You can edit images individually through the product edit page or update them in bulk using CSV imports.

Understanding product images in Xada

If your Xada instance is connected to a supplier feed, products will typically already include images supplied by them through the Promodata API. These images are automatically linked and displayed based on the supplier data.

From within Xada, you can:

  • Select which image is used as the product thumbnail
  • Deactivate images you do not want displayed on the storefront
  • Add your own images to supplement or replace supplier images

Image hosting

Xada does not host images internally. All product images must be hosted externally. This can include:

  • Third-party image hosting services (e.g. Cloudinary)
  • Your CMS or commerce platform (e.g. WordPress, BigCommerce)

Xada stores and references the image URL only.

Adding or updating product images individually

This method is recommended when updating images for a small number of products.

Steps

  1. Go to the Products page.
  2. Click Edit on the product you want to update.
  3. Scroll to the Product Images section.

From here, you can:

  • Mark an image as the thumbnail
  • Adjust the sort order
  • Deactivate images you do not want displayed

Adding a new product image

Click the Add Image button to append a new image to the existing list of product images. Enter the image URL for the image you are adding. You may also optionally provide an image description and set the image as active.

A thumbnail preview of the newly added image will be displayed. Once you have finished, click Update to save your changes.

Adding or updating product images in bulk (CSV import)

Bulk image updates are useful when managing large product catalogues or applying consistent images across multiple products.

Steps

  1. Go to the Exports page.
  2. Click "Export CSV" and choose the relevant supplier, then click "Confirm".
  3. Open the CSV file in your spreadsheet editor.
  4. Scroll to the right to locate the Product Images columns (if they exist).

Product image CSV columns

The product CSV includes five image-related columns per image. When adding new images, you must include all relevant columns and increment the number accordingly.

Example

If two images already exist (- 1    and - 2 ), a new image must use:

  • Image Active - 3   
  • Image URL - 3   
  • Image Description - 3   
  • Image Is Thumbnail - 3   
  • Image Sort Order - 3   

Failing to follow this numbering format may result in the image not being imported correctly.

Here is how each field should be populated in the CSV:

  • Image Active: Use Y if the image is active, or N if it is inactive.
  • Image URL: The publicly accessible URL where the image is hosted (e.g. Cloudinary).
  • Image Description: The image alt text. This is important for accessibility and SEO.
  • Image Is Thumbnail: Use Y if the image is the thumbnail, or N if it is not.
  • Image Sort Order: A whole number starting from 1, which determines the order in which images are displayed.

Related Articles