Skip to main content
This guide walks you through installing Kleep on your Shopify store. Kleep offers four solutions on Shopify: AI Sizing, Search, Similar Products and AI Try-On.

​
Integration Process Overview

Here’s what to expect from contract signing through go-live and beyond. The end-to-end integration typically takes around 5–6 weeks.

​
Onboarding

1

Contract signed & billing set up

Once the contract is signed, your Kleep representative kicks off billing via GoCardless: Set up direct debit →.
2

Onboarding kickoff meeting

A short call with your Kleep representative to align on timeline, technical contacts, and any store-specific requirements before installation begins.
3

Fill out the onboarding form

After the kickoff, we’ll ask you to share a few details about your company, billing, store environments, and returns setup so we can prepare the integration.Fill out our onboarding form →It takes about 5 minutes. Once submitted, our team will review your responses and confirm the next steps within 1 business day.
4

Share your Shopify URL & collaborator code

Send us your store address (e.g. your-store.myshopify.com) along with your collaborator request code so we can request access to your store.
Environments — If you have several Shopify instances (e.g. different regions or brands), please send us a collaborator code for each shop — we need one code per store.If you have multiple Shopify environments (dev, staging, production), you need to configure Kleep for each one:
  • Production store — Main store, fully configured
  • Staging/Dev stores — For testing before pushing to production
For each environment:
  1. Install the Kleep app
  2. Enable the App Embed
  3. Contact your Kleep CSM to link the environment to your account
Not sure where to find these? In your Shopify admin, go to Settings → Users and permissions — your myshopify.com URL is shown at the top, and the Collaborator request code is listed under the Collaborators section. See Shopify’s help article on collaborator accounts for more detail.
5

Accept our collaborator request

We’ll send a collaborator access request from our Shopify Partner account. Approve it from Settings → Users and permissions → Collaborators in your Shopify admin.
6

Install the Kleep app on each shop

Once we have collaborator access, we’ll send you an app installation link for each store. You’ll need to install the Kleep app separately on every Shopify store where you want Kleep enabled.
7

Choose the AI Sizing button placement

Review our suggested positions for the “Find my size” button and pick the one that fits your storefront: AI Sizing button positioning Figma →.

​
Installation & testing

1

We install Kleep on a duplicate theme

Our team duplicates your current Shopify theme and installs Kleep on the duplicate, so your live storefront stays untouched while you test.
2

Preview & feedback

We send you a private preview link to test the integration end-to-end and share any feedback or adjustments needed.
3

Go live

Once you sign off, the Kleep team runs a final QA validation (display, data quality, tracking, performance) and we publish Kleep on your live theme.

​
Post-integration

1

Client dashboard access

We provision credentials for your team to access the Kleep Dashboard, where you can monitor Kleep performance KPIs in real time.
2

Fit Feedback enabled

We enable Fit Feedback in your dashboard so your team can refine Kleep’s size recommendations using real-world fitting data.

​
Returns integration (optional)

If you use a returns management platform, Kleep can integrate return data to improve size recommendations. Supported Returns Providers
  • Global-e
  • Aftership
  • Fast Return
  • Return Go
  • Other (contact us)
Configuration
  1. In the Kleep Dashboard, go to Settings → Returns
  2. Select your returns provider
  3. Follow the provider-specific instructions to connect your account
If your provider is not listed, contact us at support@kleep.ai — we can set up a custom integration via SFTP or API.

​
Installation methods

Kleep’s storefront solutions (the AI Sizing button, Similar Products, AI Try-On) can be integrated in two ways: Each solution page below covers both paths: the standard installation and, when relevant, a Manual installation section.
If you don’t see Kleep blocks in the “Apps” tab when clicking “Add block” in the theme editor, your theme is likely a vintage theme — use the manual installation path described in each solution page.

​
Solutions

Each solution has its own page with installation, configuration and troubleshooting details:

AI Sizing

The “Find my size” button on your product pages — instant, AI-powered size recommendations.

Search

Replace the native Shopify search with an optimised search featuring size filters.

Similar Products

Suggest relevant alternatives when a size is out of stock.

AI Try-On

Let shoppers virtually try products on, straight from the product page.

​
Data imported by the Kleep app

Once installed, the Kleep app imports your product, order and return data through the Shopify Admin GraphQL API. Kleep uses this data to train and calibrate size recommendations, similar products and search. The import is read-only. Kleep never modifies your products, orders, customers or returns. The app writes only two things to your store: the Kleep tracking web pixel, and an app-owned metafield (kleep.uuid) that links the store to your Kleep account.
  • Products: title, handle, description, vendor, product type, tags, status, category, options (e.g. size, color), price and compare-at price ranges, publication and update dates, storefront URL
  • Variants: title, SKU, barcode, price, selected options, inventory quantity and inventory policy
  • Media: product and variant images (URL, alt text, dimensions)
  • Metafields and metaobjects attached to products (e.g. composition, fit, gender, color)
  • Collections: title, handle, description, image, metafields and the list of products they contain
  • Orders: order number, sales channel, creation / processing / cancellation dates and cancellation reason, total price, tags, note, test flag
  • Line items: product, variant, SKU, variant title, quantity ordered and current quantity, unit price, discount, vendor
  • Browsing context: client IP address and last referrer URL
  • Returns: return name and status, total quantity, decline reason, and for each returned item: the line item, quantity, return reason and customer note
  • Refunds: refund date, note, total refunded amount, refunded line items (SKU, quantity, amount, restocked or not), refunded shipping lines and duties
Sync frequency. At installation, Kleep imports your history (by default the last 3 years). After that, the app runs incremental syncs every few hours and only fetches records created or updated since the last successful sync.

​
How Kleep uses transactional data

Kleep uses your transactional data (orders and returns) for two purposes:
  1. Improving our algorithms. Which sizes were bought, kept or returned, and why they were returned, is the ground truth Kleep uses to train and calibrate size recommendations, similar products and search for your catalog.
  2. Measuring the impact of Kleep. Orders and returns are used to compute the KPIs that assess the solution’s performance on your store, such as conversion rate, average order value and size-related return rate, for shoppers who used Kleep compared with those who did not.
Return reasons are the most valuable signal for size recommendations. If your returns go through an external platform instead of native Shopify returns, see Returns integration. For how Kleep processes and hosts this data, see Cookies, CMP & Data Privacy.

​
Support

If you encounter issues during the integration, contact the Kleep team:

​
Thank you for using Kleep! 🎉

Our team is here to help you with installation and optimisation of your size guide.

​
Cookies & data privacy

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.