XML Feed Specification

Transferring data from your e-shop to Magrano can be done in two ways.

1. Using XML data files

For the best search results, we recommend using our recommended file format, which is described in this document.

If you have your own XML file format, we recommend that it includes all required and recommended fields.

2. Using API integration

If you want to send product data via API, please contact our technical support.

Developer info »

Product feed

Feed fields

PRODUCTS required – root element of products, listed only once in the file.
PRODUCT required – element containing information about a specific product. Each product has its own element.
ITEM_ID required – unique product ID in your e-shop
ITEM_GROUP_ID optional – product group ID
TITLE required – product name
GROUP_TITLE optional – product group name when using ITEM_GROUP_ID
DESCRIPTION optional – product description
BRAND required – product brand
CATEGORIES > CATEGORY required – product category assignment. The CATEGORY element can be repeated. You can also include the category ID from your e-shop.
URL required – product URL in your e-shop.
IMG required – product image URL in your e-shop. We recommend smaller image resolution, approximately 200x200px.
PRICE required – current product price.
SALE_PRICE recommended – sale price of the product.
MARGIN recommended – product margin.
NUM_OF_SALES recommended – number of orders for the product.
STOCK recommended – product stock quantity.
DELIVERY_DATE recommended – number of delivery days if the product is out of stock.
DELIVERY_TEXT recommended – product availability description.
PARAMS > PARAM optional – additional product parameters (size, color, etc.). The PARAM element can be repeated. Each parameter requires a name in the PARAM_KEY element and its value in the PARAM_VALUE element.
RELATED_PRODUCTS > RELATED_ITEM_ID optional – list of related products. The RELATED_ITEM_ID element can be repeated.
LABELS > LABEL recommended – list of product labels. The LABEL element can be repeated. Each label contains these fields:
- LABEL_NAME – label name (e.g. New, Sale, Hit).
- LABEL_CSS_CLASS – CSS class, if you want to use it in your design.
- LABEL_BACKGROUND_COLOR – label background color in hex format (#rrggbb).
- LABEL_TEXT_COLOR – label text color (#rrggbb).

Feed example

<?xml version="1.0" encoding="utf-8"?>
<PRODUCTS>
  <PRODUCT>
    <ITEM_ID>1</ITEM_ID>
    <ITEM_GROUP_ID>1</ITEM_GROUP_ID>
    <TITLE>Product</TITLE>
    <DESCRIPTION>Product description</DESCRIPTION>
    <BRAND>Brand name</BRAND>
    <CATEGORIES>
      <CATEGORY id="2">Main category | Category 1</CATEGORY>
    </CATEGORIES>
    <URL>https://www.yourstoreaddress.com/product</URL>
    <IMG>https://www.yourstoreaddress.com/product_image.png</IMG>
    <PRICE>19.99</PRICE>
    <SALE_PRICE>17.99</SALE_PRICE>
    <LABELS>
      <LABEL>
        <LABEL_NAME>New</LABEL_NAME>
        <LABEL_CSS_CLASS>label_new</LABEL_CSS_CLASS>
        <LABEL_BACKGROUND_COLOR>#00ff00</LABEL_BACKGROUND_COLOR>
        <LABEL_TEXT_COLOR>#ffffff</LABEL_TEXT_COLOR>
      </LABEL>
    </LABELS>
    <PARAMS>
      <PARAM>
        <PARAM_KEY>Size</PARAM_KEY>
        <PARAM_VALUE>XL</PARAM_VALUE>
      </PARAM>
      <PARAM>
        <PARAM_KEY>Color</PARAM_KEY>
        <PARAM_VALUE>Yellow</PARAM_VALUE>
      </PARAM>
    </PARAMS>
    <RELATED_PRODUCTS>
      <RELATED_ITEM_ID>2</RELATED_ITEM_ID>
    </RELATED_PRODUCTS>
  </PRODUCT>
</PRODUCTS>

Category feed

Feed fields

CATEGORIES required – root element of categories, listed only once in the file.
CATEGORY required – element containing information about a specific category. Each category has its own element.
ID recommended – unique category ID in your e-shop
PARENT_ID optional – parent category ID in your e-shop
TITLE required – category name
HIERARCHY required – category path, optional when using ID and PARENT_ID values
URL required – category URL

Feed example

<?xml version="1.0" encoding="utf-8"?>
<CATEGORIES>
  <CATEGORY>
    <ID>1</ID>
    <PARENT_ID>0</PARENT_ID>
    <TITLE>Main category</TITLE>
    <HIERARCHY>Main category</HIERARCHY>
    <URL>https://www.yourstoreaddress.com/main_category</URL>
  </CATEGORY>
  <CATEGORY>
    <ID>2</ID>
    <PARENT_ID>1</PARENT_ID>
    <TITLE>Category 1</TITLE>
    <HIERARCHY>Main category | Category 1</HIERARCHY>
    <URL>https://www.yourstoreaddress.com/category_1</URL>
  </CATEGORY>
</CATEGORIES>

Brand feed

Feed fields

BRANDS required – root element of brands, listed only once in the file.
BRAND required – element containing information about a specific brand. Each brand has its own element.
TITLE required – brand name
URL required – brand URL

Feed example

<?xml version="1.0" encoding="utf-8"?>
<BRANDS>
  <BRAND>
    <TITLE>Brand name</TITLE>
    <URL>https://www.yourstoreaddress.com/brand</URL>
  </BRAND>
</BRANDS>

Last updated: March 2026