Install and configure Kleep AI Sizing, Similar Products and Search on any storefront via our JavaScript library.
Kleep’s JavaScript library powers three front-end solutions on any storefront: AI Sizing, Similar Products, and AI Search. Use it together with the platform-specific backend integration guide (Prestashop, Magento, WooCommerce, WShop, or Custom) — that handles data ingestion, while the JS library handles the front-end experience on your storefront.
AI Sizing
“Find my size” button, tracking, and Dashboard integration
Similar Products
Out-of-stock cross-sell drawer
AI Search
On-site search component powered by Kleep
All three features share the same two prerequisites — cookie consent and library installation — covered in the sections below. Once those are in place, follow the guide for the feature(s) you want to enable.
Loading Kleep processes personal data through cookies and similar technologies. You must therefore legally condition the loading of Kleep on the visitor’s prior consent to cookies — do not call kleep.load (or load the library) until the visitor has accepted the relevant cookies in your Consent Management Platform (CMP).
Concretely: gate the <script src="https://module.kleep.ai/api/widget"> tag and the kleep.load(...) call behind your CMP’s consent callback, so they only run after consent is granted. If consent is later withdrawn, stop loading Kleep on subsequent page views.
Your CMP must expose two processing purposes, and Kleep may only be loaded once the visitor has consented to both. The exact wording to display in your banner — in 15 languages — lives on the Cookies, CMP & Data Privacy page. Copy it from there.
Load the library globally, on every page of your site — not just product pages. Add the <script src="https://module.kleep.ai/api/widget"> tag site-wide so the kleep object is available on all pages. This is required because kleep.track events fire outside of PDPs too (e.g. product_added_to_cart on the cart page, checkout_completed on the order-confirmation page), and those pages need the kleep object to be present. The product-page-specific call kleep.load(...) should still only run on PDPs.
Seeing the logs while you integrate. By default the widget runs silently. To print the full [KLEEP] [Widget] logs (loading flow, parameters, CTA creation, etc.) in your browser console, add ?debug=true to the library URL:
This URL flag is the only way to enable the verbose logs — there is no debug option on kleep.load(...). Critical warnings (unsupported lang/market, product_id/selectors mismatch, calling kleep.load twice) are always shown, even without this flag. Remove ?debug=true in production.
Kleep is fully gated by visitor consent: the script only loads after consent is collected through your CMP, and you must condition its loading accordingly. For the complete list of trackers, the data processed, the purposes and legal bases, hosting, subprocessors and security, see Cookies, CMP & Data Privacy.
