Connecting Shopify to ConvertMate

Step-by-step guide to connect your Shopify store

Last updated: Oct 4, 2025

Connecting your Shopify store to ConvertMate lets AI agents access your product catalog so they can optimize descriptions, analyze performance, and improve your marketing automation.

Before you start

Make sure you have:

  • A Shopify store on any plan (Basic, Shopify, or Advanced)
  • Admin access to your Shopify account
  • An active ConvertMate account

You don't need any technical knowledge. The connection uses Shopify's secure OAuth system, so you never share passwords or API keys directly.

Connection steps

Step 1: Go to connections

  1. Log in to your ConvertMate account
  2. Click Settings in the left sidebar
  3. Select Connections from the settings menu
  4. Find Shopify in the list of available platforms

Step 2: Start the connection

  1. Click Connect next to Shopify
  2. Enter your Shopify store URL

- Use the format: yourstore.myshopify.com - Don't include https:// or any path after the domain

  1. Click Continue

Step 3: Authorize on Shopify

Shopify will open a new window or tab asking you to review permissions:

What ConvertMate can read:
  • Product titles, descriptions, and images
  • Product variants, pricing, and inventory levels
  • Collections and product tags
  • Store metadata and settings
What ConvertMate can write:
  • Product descriptions (when you apply agent recommendations)
  • SEO meta titles and descriptions
  • Product tags for organization

ConvertMate cannot:

  • Access customer payment information
  • Process orders or refunds
  • Change your store's theme or design
  • Delete products or collections

After reviewing, click Install app to approve the connection.

Step 4: Wait for sync

After authorization:

  1. Shopify redirects you back to ConvertMate
  2. The initial data sync starts automatically
  3. You'll see a progress indicator showing sync status
Sync times:
  • Small stores (under 100 products): 1-2 minutes
  • Medium stores (100-1,000 products): 3-5 minutes
  • Large stores (over 1,000 products): 10-15 minutes

You can leave the page during sync. The process continues in the background, and you'll get a notification when it completes.

What gets synced

ConvertMate syncs this data from your Shopify store:

Product information

  • Titles and descriptions
  • Images (main and variant images)
  • Prices and compare-at prices
  • Inventory quantities (per variant)
  • Product variants (size, color, etc.)
  • Tags and product categories
  • SEO titles and meta descriptions
  • Product status (active, draft, archived)

Collections

  • Collection names and descriptions
  • Collection images
  • Product assignments
  • SEO metadata

Store settings

  • Store name and primary domain
  • Currency settings
  • Basic store information

ConvertMate does not sync customer data, order history, or payment information unless you specifically connect additional analytics platforms like Google Analytics.

How sync works

After the initial connection:

Real-time updates - When you add, edit, or delete products in Shopify, ConvertMate receives the changes within seconds through webhooks. Automatic sync - If webhooks fail or get delayed, ConvertMate performs a full sync once per day to ensure data accuracy. Manual sync - You can trigger a manual sync anytime from Settings → Connections by clicking Sync now next to your Shopify connection.

Troubleshooting connection issues

Store URL not found

If you see this error:

  • Verify your store URL is exactly yourstore.myshopify.com
  • Make sure your store is active (not paused, frozen, or closed)
  • Check that you don't have any typos in the URL

Authorization failed

If authorization fails:

  • Clear your browser cache and cookies
  • Try using an incognito or private browsing window
  • Make sure you're logged into the correct Shopify account
  • Disable browser extensions temporarily
  • Try a different browser

If the issue persists, email support@convertmate.io with a screenshot of the error.

Sync taking too long

If sync is stuck:

  • Check your internet connection
  • Verify your Shopify store is accessible (visit it in another tab)
  • Wait at least 20 minutes before assuming there's a problem
  • If still stuck after 30 minutes, click Retry sync in Settings → Connections

Missing products after sync

If some products don't appear:

  • Check that they're set to "Active" status in Shopify
  • Verify they're not in draft or archived status
  • Try a manual full resync from Settings → Connections
  • Contact support if specific products consistently fail to sync

Using agents after connection

Once Shopify is connected, you can run agents that work with product data:

Content optimization agents - These agents can now access your product catalog to generate or improve descriptions, titles, and meta data. SEO agents - Run SEO analysis on your products and collections to identify optimization opportunities. Product analytics agents - Analyze which products perform best and get recommendations for improvement.

Each agent shows whether it requires Shopify to be connected before you can run it.

Browse available agents

Disconnecting Shopify

If you need to disconnect:

  1. Go to Settings → Connections
  2. Find Shopify in your connected platforms
  3. Click Disconnect
  4. Confirm you want to remove the connection
What happens when you disconnect:
  • All product data stays in ConvertMate (it's not deleted)
  • Real-time sync stops
  • You can't run agents that require Shopify
  • You can reconnect anytime without losing historical data
To fully remove ConvertMate from Shopify:
  1. Log in to your Shopify admin
  2. Go to Settings → Apps and sales channels
  3. Find ConvertMate
  4. Click Uninstall

Security and privacy

How we protect your data:
  • OAuth 2.0 authentication (industry standard)
  • TLS 1.3 encryption for all data transmission
  • Your Shopify credentials are never stored
  • Data is encrypted at rest in our databases
Compliance:
  • GDPR compliant (EU data protection)
  • CCPA compliant (California privacy)
  • SOC 2 security standards
Read our full privacy policy

What's next

Now that Shopify is connected:

Need help with your Shopify connection? Use the chat widget in the bottom-right corner or email support@convertmate.io.

Was this article helpful?