> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kleep.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> SFRA Cartridge release history

## 26.04.0 — 2026-04-28

**Breaking changes:**

* Retailer identification now relies on a new **mandatory** `kleepRetailerUUID` site preference instead of the request host. After upgrading, set it in **BM > Site Preferences > Kleep** — otherwise tracking, the Recommendation feature and the iframe will not work.

**Enhancements:**

* Added market/locale context to the `/recommend` payload for per-market recommendation personalization.
* Removed the `isKleepSessionEnabled` preference — the session UUID logic is now always active.

**Fixes:**

* Removed customer PII from the order CSV export.
* Removed an extra empty column in the product CSV export and aligned the export format with the SFTP data structure specification.

## 25.09.0 — 2025-09-22

* New session logic with unique session UUID per session for session-based KPIs. Shared with iFrames for internal/external tracking reconciliation.
* Support for multiple categories: Shoes, Kids, Lingerie.
* Harmonized domains handler.
* 2 new custom preferences: site market (per-market KPIs / flow personalizations) and session logic enabler.
* Enhanced tracking reliability with postMessage-based triggers.

## 24.11.2 — 2024-11-12

**Fixes:**

* New `isKleepExported` boolean attribute to fix export-status querying inconsistencies.
* Fixed stringified empty object in custom attributes (now empty string).

**Enhancements:**

* Custom job timeout parameter (default: 900s).
* Max order limit parameter (default: 1000/execution).
* New order reset job for re-exports.
* Orders now always export in delta mode; remaining orders continue on next run.

## 24.11.1 — 2024-11-08

* Localized PDP CTA: FR, JA, ES, PT (PT/BR), IT, KO, DE (DE/BE), NL.
* Removed PDP CTA logo.

## 24.11.0 — 2024-11-06

**Fixes:**

* Fixed missing `SFCC_custom_attributes` column data in exports.
* Fixed KleepExportOrdersCSV Full export option.

**Enhancements:**

* Removed 1000-order export limit.
* Enhanced logging for both export jobs.
* Retry feature in KleepExportOrdersCSV for failed orders.

## 24.10.2 — 2024-10-23

* Updated recommendation modal URL.

## 24.10.1 — 2024-10-21

**Enhancements:**

* Export includes all variants/variation groups when at least one is categorized. Quota: 20,000 masters.
* New `SFCC_Product_VariationGroups_ID` CSV column.
* Removed unused `[BRAND]` config in job steps.
* Orders export filtered to "Exported" status only.
* Multiple Kleep CTAs supported anywhere in PDP. Removed CTA loading spinner.
* Real-time inventory check before suggesting a product. New `button_clicked` event.

**Fixes:**

* Fixed KleepExportOrdersCSV crash on orders with notes.

## 24.10.0 — 2024-10-07

**Enhancements:**

* API 21.2 compatibility for recommendation modal URL.
* Export chunk size 1000→100, cleaned empty/duplicate lines, better logs, auto-trim `MainViewType`.

**New Features:**

* `ExportType` parameter (Delta/Full) without deleting CustomObject.
* Categories names/IDs in products export.

**Fixes:**

* Job status showing "OK" in BM while "ERROR" in backend.
* `KleepExportDateTracker` creation bug on job errors.
* Export includes variants from variation groups when masters are uncategorized.

## 24.9.0 — 2024-09-25

**Fixes:** AddToCart from pop-up; missing `kleepLastExported` in metadata.

**Enhancements:** KleepExportProductsCSV compatibility with SFCC API 21.2.

## 24.8.0 — 2024-08-30

**Fixes:** Resolved PDP console errors.

**Enhancements:** Recommendation feature uses VariationGroups instead of Masters.

## 24.7.0 — 2024-07-03

**Enhancements:** Delta export by `lastModified` date. Absolute image URLs in tracking. Optimized API calls.

**New Features:** Event tracking: `product_added_to_cart`, `checkout_completed`, `checkout_validated`.

**Fixes:** Frontend compilation. Job export crash on missing custom object.

## 24.6.0 — 2024-06-10

Initial release.