Shopify app
Connect a Shopify store for monitoring after a product-page audit.
TL;DR: The Shopify app is Colter's continuation layer. It connects the shop to a monitoring site. You then choose whether to enable a theme extension that records browser-like automated visits. The app does not edit product content during installation or monitoring setup.
Start with the product page
Use the Recommendation Audit first. Paste a Shopify product link and Colter tells you how to improve the page.
The buyer question you enter is saved for a later real-answer comparison. It does not affect the page score or fix selection.
What installation does
- Shopify completes the app authorization and stores the app session.
- On the first authenticated app load, Colter connects the shop to a monitoring site.
- The app reads the existing
colter.lens_site_idmetafield. It writes the exact provisioned site ID only when the value is missing or different. - Shopify registers product, shop, checkout, order, subscription, uninstall, and privacy webhooks for the app.
- The merchant can open the Shopify theme editor and enable the optional Colter Monitoring extension.
The extension is not silently enabled during installation.
What the theme extension records
When enabled, the storefront script sends the Colter site ID, page path without query parameters, referrer, user agent, and event time for storefront page views. Colter then classifies the visits using the available browser signals.
It cannot see most direct crawlers because they do not run storefront JavaScript. Use request-level edge collection or server logs when broader crawler coverage is needed.
A recorded visit does not prove that an AI assistant recommended a product.
What Colter does not change
Installation and monitoring setup do not edit product titles, descriptions, prices, images, inventory, or product-page content. The embedded app retains a separate legacy route for merchant-selected theme changes, but nothing is applied without an explicit merchant action.
Shopify access
| Access | Current use |
|---|---|
| Products | Queue a refresh of stored public-page evidence after product changes |
| Themes | Resolve the active theme, open monitoring setup in Shopify's editor, apply a supported theme-file change only after merchant selection, and clean up paid Colter theme artifacts after a downgrade or uninstall |
| Checkouts and orders | Send Shopify events to Colter for later activity matching |
| Shop and metafields | Connect the shop and store the monitoring site ID |
The installed app does not request Shopify analytics access.
Troubleshooting
| Issue | What to do |
|---|---|
| Monitoring site not found | Reopen Colter from Shopify admin so setup can retry |
| No visits recorded | Confirm Colter Monitoring is enabled in the theme editor |
| Direct crawlers missing | Use request-level edge collection or server logs |
| Theme-editor link unavailable | Reopen the app or contact team@agenticcom.ai |