Documentation

Setup guide and feature walkthrough for AI Conversion Detective.

1. Installing the App

Install AI Conversion Detective from the Shopify App Store. You will be redirected to your Shopify Admin and prompted to approve the required permissions. Once approved, the app opens automatically inside your Shopify Admin.

Required permissions:

• Products — to analyse product pages for conversion issues
• Orders — to calculate revenue impact estimates
• Customers — to count active customers for conversion rate calculations
• Themes — to analyse your store's design and UX
• Analytics — to understand traffic patterns and conversion rates

2. Running Your First Scan

After installing, you land on the dashboard. Click Run Store Scan to start your first analysis. The scan typically takes 1–3 minutes depending on the size of your store. You can navigate away — the scan runs in the background and you will see the results when you return.

3. Understanding Your Scan Results

Results are displayed as a list of conversion issues, each showing:

• Severity — Critical, High, Medium, or Low
• Revenue impact estimate — how much this issue may be costing you per month
• Affected page / element — exactly where the issue occurs
• Recommended fix — a specific, actionable step to resolve it

Issues are sorted by revenue impact by default so you can focus on what matters most first.

4. Using the AI Chat

The right panel of the dashboard contains an AI chat powered by Claude. You can:

• Ask follow-up questions about any specific issue
• Request more detail on a recommendation
• Ask about general conversion best practices for your store type
• Ask "what should I fix first?" for a prioritised action plan

Chat messages count toward your weekly limit depending on your plan. Your limit resets every Monday.

5. Re-scanning Your Store

You can trigger a new scan at any time from the dashboard. The app also automatically queues a re-scan when significant changes are detected — such as a theme being published or a large batch of product updates.

6. Managing Your Plan

Go to Billing & Plans in the app navigation to view your current plan, see your weekly message usage, and upgrade or downgrade. All billing is handled by Shopify — you will never be asked for payment details within the app itself.

• Free Trial — 1 scan, up to 10 AI messages per week
• Starter ($29/month) — Unlimited scans, up to 50 AI messages per week
• Pro ($59/month) — Unlimited scans, up to 500 AI messages per week, deep audit mode

7. Uninstalling

You can uninstall from Shopify Admin → Settings → Apps → AI Conversion Detective → Delete. All your data is permanently deleted within 48 hours of uninstalling. If you reinstall later, the app starts fresh with a new scan.

Need Help?

If something isn't working as expected, visit our support page or check the FAQ.