> For the complete documentation index, see [llms.txt](https://docs.sizebay.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sizebay.com/fashion-hub/product-integration-xml-feed.md).

# Product Integration (XML Feed)

### 1. Requirements

The XML feed should be segmented by each unique combination of country, language, and currency to ensure accurate localization. 

| Parameter          | Description                             | Required for Separate Feed? |
| ------------------ | --------------------------------------- | --------------------------- |
| `target_country`   | Country where the product is sold       | ✅                           |
| `content_language` | Language used for product content       | ✅                           |
| `currency`         | Currency in which the product is priced | ✅                           |

> **Rule of thumb**:\
> You must provide **one XML feed per unique combination** of `target_country` + `content_language` + `currency`

### 2. XML Tags & Descriptions

| Field                       | Description                                  | Required |
| --------------------------- | -------------------------------------------- | -------- |
| `id`                        | Unique ID of the variant (e.g. color + size) | ✅        |
| `item_group_id`             | Common ID for all variants of a product      | ✅        |
| `title`                     | Product title (localized)                    | ✅        |
| `description`               | Product description (localized)              | ❌        |
| `link`                      | Product detail page URL (localized)          | ✅        |
| `image_link`                | Main image of the variant                    | ✅        |
| `additional_image_link`     | Additional images for the variant            | ❌        |
| `brand`                     | Product brand                                | ✅        |
| `product_type`              | Product taxonomy (breadcrumb-style format)   | ✅        |
| `price`                     | Regular price                                | ✅        |
| `sale_price`                | Promotional price (if applicable)            | ❌        |
| `sale_price_effective_date` | Promotion date range (ISO 8601 format)       | ❌        |
| `availability`              | Stock status (`in stock`, `out of stock`)    | ✅        |
| `size`                      | Variant size                                 | ✅        |
| `color`                     | Variant color                                | ❌        |
| `gender`                    | Target gender (`male`, `female`, `unisex`)   | ✅        |
| `age_group`                 | Target age group (`adult`, `kids`)           | ✅        |
| `gtin`                      | GTIN / EAN / UPC                             | ❌        |

### 3. Sample XML Entry

```
<item>
  <id>12345-RED-M</id>
  <item_group_id>12345</item_group_id>
  <title>Basic Men's T-Shirt - Red</title>
  <description>Comfortable cotton t-shirt for daily wear.</description>
  <link>https://store.com/en/product/basic-tshirt-red</link>
  <image_link>https://store.com/img/12345-red.jpg</image_link>
  <additional_image_link>https://store.com/img/12345-red_1.jpg</additional_image_link>
  <brand>Nike</brand>
  <product_type>Apparel & Accessories > Clothing > Tops > T-Shirts</product_type>
  <price>49.90 USD</price>
  <sale_price>39.90 USD</sale_price>
  <sale_price_effective_date>2025-06-01T00:00:00/2025-06-07T23:59:59</sale_price_effective_date>
  <availability>in stock</availability>
  <size>M</size>
  <color>Red</color>
  <gender>male</gender>
  <age_group>adult</age_group>
  <gtin>7891234567890</gtin>
</item>
```

### 4. Feed Update Frequency

Sizebay fetches your XML feed **once per day** at **05:00 AM (GMT+0)**.

* **If the product does not exist**, it will be **automatically added** to our system.
* **If the product already exists**, it will be **updated** based on changes in:
* `title`
* `price`
* `sale_price`
* `sale_price_effective_date`
* `availability`

> Make sure your XML is accessible and up-to-date before the scheduled fetch time.