Get Started

Connect ideal.shop to Clerk.io with an AI Integration for data syncing and the built-in integration for Clerk.js and sales tracking. Then configure Search and Recommendations for your theme.
Enable Integration #
Connect the matching Clerk.io Store before setting up your storefront Elements.
- In ideal.shop, go to Indstillinger > Integrationer and open Clerk.io.
- In my.clerk.io, open your Store and go to Developers > API Keys.
- Copy the public API key into Public API key in ideal.shop.
- Copy the legacy private API key into Private API key.
- Enable Aktivér tracking. Enable Feed offentligt only if you plan to use the alternative native JSON feed.
- Click Gem.
Check for existing Clerk.js and sales tracking code before adding anything manually. Enabling the native integration alongside a separate installation can cause duplicate requests or sales events.
Configure Products #
Import data first so your Designs, filters, and page context use real webshop records.
- Follow Sync Data to create an API user, configure the recommended AI Integration for all data types, and include pages through the sitemap.
- Set up Recommendations with verified page IDs and placement targets.
- Set up Search for your desktop and mobile inputs.
- Keep Elements in In preview while testing.
Selectors, module IDs, layouts, and native JavaScript functions vary between themes. The Fodmagasinet examples in these guides show how to investigate a theme; check each value on your own webshop.
Dynamic Navigation #
Some themes replace page content without a full reload. Clerk.io must discover the replacement content and use its current IDs.
In my.clerk.io, check Settings > Features > SPA Auto Detect Changes. This lets Clerk.js detect dynamically loaded content. Test navigation after enabling it: the setting alone does not prove that every theme update works.
Verify product-to-product navigation, category pagination, basket updates, and Back/Forward. If recommendations disappear or use an earlier page’s ID, follow the navigation FAQ.
Verify Setup #
Use this checklist before changing Elements from Preview to Live. Follow the general Recommendations and Search best practices for choosing experiences.
- Open intended pages with
?clerk_content_mode=preview(or&clerk_content_mode=previewwhen a query already exists). Recheck the mode after native pagination or navigation. - Check desktop and mobile layouts: native page width, readable cards, clear prices, sharp images, working slider arrows, and no horizontal page overflow.
- Visit two different products, categories, and articles. Confirm each Element sends the current imported ID.
- Add, remove, and change basket quantities in an agreed test basket. Confirm recommendations use the current product IDs and handle an empty basket.
- Test simple-product purchasing, required variant choices, unavailable products, and error messages. Restore the test basket afterwards.
- Open, type in, close, and reopen Search. Test Escape, arrow-key selection, Enter, and mobile controls. Closing Search must preserve the underlying page and scroll position.
- Repeat navigation and Back/Forward after using Search. Check for missing Elements, stale results, duplicate placements, or duplicate requests from the same Element.
- Confirm Clerk.js loads through the native integration and that only one installation initializes the Store. Inspect browser Network requests and console errors.
- Verify sales tracking against an agreed test order or an existing completed order with tracking evidence. Check the order ID, product IDs, quantities, prices, and a single sales event. A successful data sync alone does not verify frontend tracking.
- Explicitly open
?clerk_content_mode=liveto exit Preview. Removing the Preview parameter alone may leave Preview active. Confirm the intended Live experience.
Keep temporary fixes out of the standard installation. See the FAQ for feed, theme, and navigation edge cases.