The XML feed is available for Starter, Advanced, Business and Enterprise plans.
Connecting your XML feed to your Agent will take 1-5 minutes.
Adding XML Feed
Follow the steps below to connect your XML feed.Add Feed
Add your XML feed by pasting the feed URL into the input field and clicking Add feed. Only XML feeds are supported — sitemaps and JSON feeds are not accepted.
The maximum file size is 50 MB per XML feed.
XML feed options
You can manage your feeds by clicking the Options button.- Delete – Removes the selected feed and all associated product data.
- Synchronize – Updates only the selected feed, instead of syncing all feeds at once.
How the XML feed fits in your agent
XML feed and Website connect
When using the XML feed together with Website, make sure the crawler skips all product pages. These pages are already included in the XML feed, and crawling them again could cause overlapping or inconsistent information for the Agent. You can also connect XML product feeds from external tools such as Channable, Producthero, or DataFeedWatch. These platforms make it easy to generate structured product feeds that your Agent can use directly — while your Website focuses on other content like blog posts, help pages, or category descriptions.General requirements for an XML feed
Before looking at specific fields, your XML feed should meet these basic requirements:- The feed must be publicly accessible via a URL
- The feed format must be XML
- The feed must contain structured product-level data
- Each product should appear once in the feed
- The feed should be updated when products change
Required fields in an XML feed
To work properly with Watermelon, your XML feed must contain at least the following fields for each product.| Field | Explenation | Values | Example |
|---|---|---|---|
| Product ID | A unique identifier for each product | - Must be unique per product - Should not change over time - Can be a SKU, internal ID, or database ID | <id>12345</id> |
| Product title / name | The name of the product as shown to customers. | - Clear and descriptive - Avoid internal codes/names only - Prefer the full product name | <title>Wireless Noise Cancelling Headphones</title> |
| Product description | A textual description of the product. | - Can be short or long - Plain text is preferred - Avoid HTML where possible - This field is crucial for helping your Agent explain what a product is and what it’s used for. | <description>Wireless headphones with active noise cancellation and 30 hours of battery life.</description> |
| Product URL | The direct URL to the product page on your webshop. | - Must be a full URL (including https) - Should lead to a live, accessible page | - <link>https://www.example.com/products/phones</link> |
| Price | The current selling price of the product. | - Use a consistent format - Clearly define the currency - Exclude additional text | - <price>199.99</price> or <price currency="EUR">199.99</price> |
| Availability | Indicates whether the product is available for purchase. | - This helps your Agent avoid recommending unavailable products. | - <availability>in stock</availability> |
Strongly recommended fields
While not strictly required, these fields greatly improve the quality of your Agent’s answers.- Brand: Helps distinguish similar products and improves filtering.
- Example:
<brand>Sony</brand>
- Example:
- Category: Helps your Agent understand how products relate to each other.
- Example:
<category>Audio > Headphones</category>
- Example:
- Variants (if applicable): If your product has variants (size, color, material), include them clearly.
- Use separate variant entries or
- Include structured variant fields
- Example:
<color>Black</color>or<size>Medium</size>