Catalog Feeds

Setting a catalog feed in the Recombee Admin UI is an alternative to uploading the items catalog using our API.

We periodically download your feed and update items accordingly. The default update period is 4 hours - if it does not match your specific needs, please contact support@recombee.com.

  • Supported protocols for fetching: http, https, ftp and sftp.
  • Supported feeds compressions: .zip and .gz.

We support the following types of feed formats:

  • The property name itemId is reserved.
  • Items deleted from feeds are not deleted in Recombee catalog. Instead, they can be updated as not available. For more details see Handling of removed items.

The IDs of the items in Recombee may consist of digits, latin letters, underscores, colons, minus signs, at sign, and dot.

If the IDs in your feed do not follow this format (the ID is for example the URL of the item), enable the MD5 Item IDs option in the Settings. An MD5 hash of the original ID value is then used as the ID.

You then need to use the MD5 hash also when you send interactions to Recombee and when you request Items to Item recommendation.

In JavaScript the MD5 hash of the original ID can be obtained for example like this:

HTML
<script src="https://cdnjs.cloudflare.com/ajax/libs/blueimp-md5/2.18.0/js/md5.js"></script>

<script type="text/JavaScript">
	var itemId = md5('<original item ID>');

	// Use the itemId when sending interactions to Recombee / asking for Items to Item recommendation
</script>

The Feeds processor can automatically set items that have been removed from the feed as unavailable.

To use this feature, pick the item property that determines availability, and provide the value which denotes the unavailable items:

Setting Availability property

You can then use this item property in your Filters.

© Copyright 2026, Recombee s.r.o
docs.recombee.com