Skip to main content

Shopify Installation Guide

Get started with Synton AI on your Shopify store. Installation takes less than 5 minutes.

Prerequisites​

Before installing, ensure you have:

RequirementDetails
Shopify StoreActive Shopify store on any plan
Store Owner RoleAdmin access to install apps
Theme AccessAbility to customize theme (for app embeds)
Shopify Plan Support

Synton AI works with all Shopify plans: Basic, Shopify, Advanced, and Shopify Plus.

Step 1: Install from Shopify App Store​

  1. Visit the Shopify App Store
  2. Search for "Synton AI"
  3. Click on the Synton AI app listing
  4. Click Add app
  5. Review the permissions requested:
    • Read and write products
    • Read and write orders
    • Read customers
    • Read and write discounts
    • Read and write theme files
  6. Click Install app

You'll be redirected to the Synton AI dashboard within Shopify.

Step 2: Enable App Embed​

For the best experience, enable the Synton AI app embed in your theme:

  1. After installation, you'll see a prompt: "Enable app embed"
  2. Click Enable
  3. You'll be taken to your theme customizer
  4. In the left sidebar under App embeds, toggle Synton AI to ON
  5. Click Save in the top right
What is App Embed?

App embeds allow Synton AI to inject widgets (reviews, upsells, chatbot) into your store without manual code editing.

Step 3: Configure Initial Settings​

  1. In the Synton AI dashboard, click Settings in the left navigation
  2. Review and configure:
    • Store Information: Verify your store details
    • AI Preferences: Select your preferred AI interaction style
    • Notifications: Choose which events you want to be notified about

Step 4: Have Your First Conversation​

  1. Click Chat in the left navigation
  2. The AI will greet you and offer suggestions
  3. Try these starter commands:
"Show me my top 5 products by revenue"
"What were my sales yesterday?"
"Create a 20% discount code called WELCOME20"

The AI will execute these commands and provide results immediately.

Verification​

To verify the installation is working correctly:

Check API Connection​

  1. Go to Settings > Integrations in Synton
  2. You should see Shopify with a green Connected status
  3. Click Test Connection to verify API access

Check Data Sync​

  1. In the Chat, ask: "How many products do I have?"
  2. The AI should return an accurate count matching your Shopify admin

Check App Embed​

  1. Visit your online store
  2. Open browser developer tools (F12)
  3. Search the page source for synton-ai
  4. You should see the app embed script loaded

Webhook Configuration​

Synton AI automatically sets up webhooks for real-time updates. To verify:

  1. In Shopify admin, go to Settings > Notifications
  2. Scroll to Webhooks
  3. You should see entries for:
    • orders/create
    • orders/updated
    • products/create
    • products/update
    • products/delete
    • customers/create

All should point to https://shopify.synton.ai/webhooks

tip

If webhooks are missing, Synton AI will automatically recreate them. No action needed.

Troubleshooting​

"App failed to install"​

Cause: Shopify API timeout or temporary network issue

Solution:

  1. Refresh the page
  2. Try installing again
  3. If persists, contact Shopify support to verify app approval status

"Permission denied" errors​

Cause: Your Shopify user role doesn't have app installation permissions

Solution:

  1. Ensure you're logged in as the store owner
  2. Or request a staff account with "Apps and channels" permission
  3. Have the owner install the app and grant you access in Synton

App embed not showing​

Cause: Theme customizer didn't save or conflicts with theme

Solution:

  1. Go to Shopify admin > Online Store > Themes
  2. Click Customize on your active theme
  3. Navigate to App embeds in left sidebar
  4. Toggle Synton AI on and click Save
  5. If still not working, check for JavaScript errors in browser console

Data not syncing​

Cause: Webhook delivery failure or API rate limiting

Solution:

  1. In Synton, go to Settings > Integrations > Shopify
  2. Click Sync Now to trigger manual sync
  3. Check webhook status in Shopify admin
  4. Review sync logs in Synton under Settings > Logs

Chat not responding​

Cause: Network issue or temporary API outage

Solution:

  1. Check status.synton.ai for service status
  2. Refresh the page
  3. Clear browser cache and try again
  4. If persists, contact support with the conversation ID shown in error message

Next Steps​

  1. Open Your Dashboard at app.synton.ai
  2. Complete Onboarding — Follow the guided setup in your dashboard
  3. Explore AI Agents — Let Synton start analyzing and optimizing your store

Support​