Last updated: May 2026 Category: Integrations
Overview
The Clerk.io integration brings AI-powered product recommendations into your BeyondCart mobile app. You can show "Customers also bought", "Trending now", "Recommended for you", and other Clerk.io recommendation widgets directly on the home screen and product pages — using the same recommendation engine that powers your web store.
Use cases and benefits
Cross-sell and upsell with proven recommendation methods like "Frequently bought together" and "Customers who bought this also bought".
Reuse your Clerk.io setup — recommendation rules, exclusions, and merchandising configured in Clerk.io apply to the app automatically.
No manual product tagging — Clerk.io's models keep working as your catalog evolves.
Prerequisites
A Clerk.io account.
Clerk.io connected to your Shopify store with at least one tracking session collected.
Admin access to your BeyondCart dashboard.
Setup instructions
1. Get your Clerk.io public API key
Log in to your Clerk.io dashboard at https://clerk.io.
Open My Account → API Keys.
Copy your Public API Key — it identifies your store to Clerk.io's recommendation API. (The Public Key is safe to embed in mobile app traffic; do not paste your Private Key, which is for server-to-server use only.)
2. Paste the key into BeyondCart
Open your BeyondCart admin dashboard.
Go to Site Settings → Integrations.
Find the Clerk.io section.
Paste your Public API Key into the Clerk.io API Key field.
Click Save.
3. Place Clerk.io widgets in your app
Clerk.io widgets are placed via the BeyondCart Template Builder. Each widget is a configurable block that calls a specific Clerk.io recommendation method.
Open Templates → your active template in the admin.
Add a Clerk.io widget block.
Configure:
Title — what the customer sees above the widget (e.g., "You may also like").
Method — the Clerk.io endpoint to call. Common options include
recommendations/products/popular,recommendations/products/trending,recommendations/products/related, andrecommendations/products/cross-sell.Number of items — how many products to show. Defaults to 6.
Save and publish the template.
For product-page widgets (e.g., "Customers also bought"), the current product's ID is sent to Clerk.io automatically so the recommendation is contextual.
What customers see in the app
A horizontal scrollable product list rendered by the same components that power BeyondCart's other product widgets.
Products are pulled from Clerk.io's recommendations and displayed with their title, price, and image — fully native, no webview.
If Clerk.io returns no recommendations (e.g., new store with insufficient training data), the widget hides itself rather than showing an empty section.
Tips and best practices
Start simple. "Trending now" and "Popular in
" work well from day one. Personalized methods like "Recommended for you" need user history to perform well.
Mix product-page and home-page widgets. Cross-sell on the product page; discovery widgets on home.
Watch the recommendation count. Six items is a good default — too many slows scroll, too few feels weak.
Confirm Clerk.io is tracking app traffic. Open Clerk.io's dashboard and look at session counts. If you don't see growth after the integration is live, double-check the API key.
Troubleshooting
Widget shows nothing in the app. The widget hides when Clerk.io returns zero results. Common reasons: the API key is wrong; Clerk.io is still importing your catalog (takes a few hours after first install); or the chosen method doesn't have enough data yet. Try switching to popular or trending while you wait for personalized methods to warm up.
Wrong products are recommended. Open Clerk.io and check the configuration for that recommendation method. You can pin, exclude, or boost specific products in Clerk.io's merchandising tools — the change applies to the app instantly.
Widget loads slowly. Clerk.io is generally fast, but if your Shopify catalog is large, the initial load on cold cache can take a moment. Subsequent visits are cached on the device.
Related Articles