All docs

Getting started

Installing Synton AI

Follow these simple steps to install Synton AI on your e-commerce store.

Follow these simple steps to install Synton AI on your e-commerce store.

Supported Platforms: Shopify, WooCommerce, BigCommerce, PrestaShop, and Magento 2.

Prerequisites

Before installing, make sure you have:

  • An active e-commerce store on Shopify, WooCommerce, BigCommerce, PrestaShop, or Magento 2
  • Admin access to your store
  • A modern web browser (Chrome, Firefox, Safari, or Edge)

Installation by Platform

Choose your platform for specific installation steps:

Shopify Installation

Step 1: Find Synton AI in the Shopify App Store

  1. Log in to your Shopify admin
  2. Go to Apps in the left sidebar
  3. Click Customize your store or visit the Shopify App Store
  4. Search for "Synton AI"
  5. Click on the Synton AI app listing

Step 2: Install the Shopify App

  1. Click the Add app button
  2. Review the permissions Synton AI requests:
    • Read and write - Theme files, products, orders, customers, discounts
    • Read only - Store settings, analytics data
  3. Click Install app to approve

Why these permissions?

Synton AI needs these permissions to:

  • Create and manage products, discounts, and collections
  • Access order and customer data for AI analytics
  • Deploy modules that enhance your store
  • Integrate widgets with your storefront

All permissions are standard for AI-powered store management apps.

WooCommerce Installation

Step 1: Go to the Universal Dashboard

  1. Visit app.synton.ai
  2. Click Get Started or Login
  3. Select WooCommerce as your platform

Step 2: Connect Your WooCommerce Store

  1. Enter your WooCommerce store URL (e.g., https://yourstore.com)
  2. You'll be redirected to your WordPress admin
  3. Authorize Synton AI to connect via WooCommerce REST API
  4. Grant the requested permissions

Required WooCommerce permissions:

  • Read/Write access to Products, Orders, Customers
  • Read access to Reports and Settings

Step 3: Verify Connection

  1. Return to the Synton AI dashboard
  2. Your store should appear in your account
  3. Complete the setup wizard

BigCommerce Installation

Step 1: Go to the Universal Dashboard

  1. Visit app.synton.ai
  2. Click Get Started or Login
  3. Select BigCommerce as your platform

Step 2: Connect Your BigCommerce Store

  1. Enter your BigCommerce store URL
  2. You'll be redirected to BigCommerce to authorize
  3. Review and approve the requested permissions
  4. Complete the OAuth flow

Required BigCommerce permissions:

  • Read/Write access to Products, Orders, Customers
  • Read access to Store Information

Step 3: Verify Connection

  1. Return to the Synton AI dashboard
  2. Your store should appear in your account
  3. Complete the setup wizard

PrestaShop Installation

Step 1: Download the Module

  1. Visit app.synton.ai
  2. Click Get Started or Login
  3. Select PrestaShop as your platform
  4. Download the Synton AI module (.zip file)

Alternatively, find Synton AI on the PrestaShop Addons Marketplace.

Step 2: Install via PrestaShop Back Office

  1. Log in to your PrestaShop Back Office
  2. Go to Modules → Module Manager
  3. Click Upload a module (top right)
  4. Select the downloaded syntonai.zip file
  5. Wait for installation to complete

Step 3: Configure the Module

  1. Find "Synton AI" in your module list
  2. Click Configure
  3. Enter your Synton AI API key (from app.synton.ai)
  4. Click Save
  5. Click Open Dashboard to access the full Synton AI interface

Required PrestaShop permissions:

  • Access to Products, Orders, Customers APIs
  • Hook permissions for analytics tracking
  • Configuration storage access

Step 4: Verify Connection

  1. Return to the Synton AI dashboard at app.synton.ai
  2. Your PrestaShop store should appear connected
  3. Complete the setup wizard

Magento 2 Installation

Step 1: Install via Composer (Recommended)

Connect to your Magento server and run:

composer require syntonai/module-syntonai
bin/magento module:enable Syntonai_Module
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Alternatively, download from the Adobe Commerce Marketplace.

Step 2: Configure in Magento Admin

  1. Log in to your Magento Admin Panel
  2. Go to Stores → Configuration → Synton AI
  3. Enter your API key (from app.synton.ai)
  4. Configure your preferences:
    • Enable/disable bot detection
    • Set analytics tracking options
    • Configure module sync preferences
  5. Click Save Config

Step 3: Clear Cache

After configuration, clear your Magento cache:

bin/magento cache:flush

Or via Admin: System → Cache Management → Flush Magento Cache

Step 4: Access the Dashboard

  1. In Magento Admin, go to Marketing → Synton AI → Dashboard
  2. Click Open Full Dashboard to access app.synton.ai
  3. Your Magento store should appear connected
  4. Complete the setup wizard

Required Magento permissions:

  • Syntonai_Module::config - Configuration access
  • Catalog API - Product management
  • Sales API - Order access
  • Customer API - Customer data access

All Platforms: Choose Your Plan

After installation, you'll see the pricing plans:

PlanPriceCredits/monthStoresBest For
No plan$0/monthNone1Exploring every app before you commit
Growth$49/month10,000Up to 3Small stores getting started
Professional$179/month32,250Up to 3Growing stores with broader automation
Business$1,299/month292,500Up to 10Multi-store operations
Enterprise$3,999/month975,000UnlimitedHigh-volume teams

Every plan includes every app, at no extra cost and with no cap on how many you install — that is true before you pay too. What a paid plan adds is AI credits.

All paid plans also include:

  • Every AI agent
  • 50% credit rollover
  • Priority support

Credits meter your AI usage: a typical chat turn costs about 16. You can buy a credit top-up at any time from Billing, under the Usage tab.

What are modules?

Modules are powerful features you deploy to your store (like reviews, loyalty programs, chatbots). See Understanding Modules for details.

Explore first, pay when you want AI

You do not have to choose anything here. With no plan you can connect your store, open every app, and run unlimited store health and security audits. There is no trial period and no signup credits: the first time you ask for AI work, Synton asks you to pick a plan.

When you are ready:

  1. Choose a plan (monthly or yearly — yearly saves about 17%)
  2. Enter your payment details:
    • Shopify: Billed through Shopify billing, on your Shopify invoice
    • WooCommerce/BigCommerce/PrestaShop/Magento, or no store connected: Billed via Stripe
  3. Click Confirm

Your credits appear on your balance as soon as the payment confirms.

Step 4: Grant Additional Permissions (Optional)

For advanced features, Synton AI may request additional permissions:

Meta Ads Optimizer

  • If you want AI-powered Meta advertising, you'll connect your Facebook Business account later
  • This is optional and can be done from Settings

Google Ads

  • For Google Ads management, you'll connect your Google Ads account
  • Also optional and configurable later

You can skip these during installation and set them up when ready.

Verification

After installation, you should see:

  1. Synton AI listed in your Apps section
  2. A welcome screen with a chat interface
  3. A quick tour of the dashboard

What's Installed?

Shopify:

  1. App in your Shopify Admin - Accessible from the Apps menu
  2. Theme App Extension - Allows modules to integrate with your theme
  3. Webhook Subscriptions - For real-time updates about orders, products, etc.

WooCommerce:

  1. API Connection - Secure connection via WooCommerce REST API
  2. Webhook Subscriptions - For real-time updates
  3. Widget snippets - Added via shortcodes or code blocks

BigCommerce:

  1. API Connection - Secure OAuth connection
  2. Webhook Subscriptions - For real-time updates
  3. Script Manager - Widgets installed via Script Manager

PrestaShop:

  1. Module in Back Office - Accessible from Module Manager
  2. Hook Integrations - For analytics tracking and widget display
  3. API Endpoints - Secure REST API for Synton AI communication
  4. Admin Configuration - Settings page for customization

Magento 2:

  1. Extension in Admin - Accessible from Marketing menu
  2. Web API Routes - Secure REST endpoints
  3. Service Contracts - Following Magento patterns for data access
  4. Admin Configuration - Full system configuration integration
  5. Database Schema - Analytics and bot detection tables

Important: Synton AI does NOT automatically modify your theme during installation. You must explicitly request changes through the AI chat.

Uninstalling

If you need to uninstall Synton AI:

Shopify:

  1. Go to Apps in Shopify admin
  2. Click on Synton AI
  3. Click the three dots (...) in the top right
  4. Select Delete or Uninstall

WooCommerce:

  1. Go to app.synton.ai → Settings
  2. Select your WooCommerce store
  3. Click Disconnect Store
  4. (Optional) Remove Synton shortcodes from your site

BigCommerce:

  1. Go to app.synton.ai → Settings
  2. Select your BigCommerce store
  3. Click Disconnect Store
  4. (Optional) Remove Synton scripts from Script Manager

PrestaShop:

  1. Go to Modules → Module Manager in PrestaShop Back Office
  2. Find Synton AI in the list
  3. Click the dropdown arrow and select Uninstall
  4. Choose whether to keep module data
  5. (Optional) Go to app.synton.ai → Settings to disconnect

Magento 2:

  1. Connect to your Magento server and run: 
    bin/magento module:disable Syntonai_Module
bin/magento setup:upgrade
composer remove syntonai/module-syntonai
bin/magento cache:flush
  2. (Optional) Go to app.synton.ai → Settings to disconnect

What happens when you uninstall (all platforms):

  • All deployed modules stop working
  • Theme modifications remain (you can manually remove them if needed)
  • Your data is retained for 30 days in case you reinstall
  • After 30 days, all data is permanently deleted

Troubleshooting

Installation Failed

If installation fails:

  1. Check your platform - Synton AI works on all Shopify plans, WooCommerce 5+, BigCommerce plans, PrestaShop 8+, and Magento 2.4+
  2. Clear your browser cache - Sometimes helps with permission issues
  3. Try a different browser - Use Chrome or Firefox
  4. Check API access - Ensure REST API is enabled:
    • WooCommerce: WooCommerce → Settings → Advanced → REST API
    • BigCommerce: Advanced Settings → API Accounts
    • PrestaShop: Advanced Parameters → Webservice
    • Magento: System → Integrations
  5. Check PHP version - PrestaShop requires PHP 8.0+, Magento requires PHP 8.1+
  6. Contact support - Email support@synton.ai with error details

App Not Showing After Installation

Shopify:

  1. Refresh your Shopify admin page
  2. Check the Apps menu - it may take a few seconds to appear
  3. Wait 1-2 minutes and check again
  4. If still missing, try reinstalling

WooCommerce/BigCommerce:

  1. Go to app.synton.ai
  2. Log in with your account
  3. Check if your store appears in the dashboard
  4. If not, try reconnecting

Permission Errors

If you see permission errors:

  1. Make sure you're logged in as Store owner or have Admin access
  2. Shopify: Some permissions require specific Shopify plan features
  3. WooCommerce: Ensure your API keys have read/write permissions
  4. BigCommerce: Check that all requested OAuth scopes were approved
  5. PrestaShop: Verify you have SuperAdmin role or necessary module permissions
  6. Magento: Check ACL permissions in System → Permissions → User Roles
  7. Contact your store owner if you're a staff member

Next Steps

Now that Synton AI is installed, let's take your first steps:

  1. Complete the initial setup and start chatting
  2. Learn about modules and deploy your first one
  3. Explore the AI Command Center

Need Help?

  • Live Chat - Click the chat icon in the app
  • Email - support@synton.ai
  • Status - status.synton.ai

Congratulations! You're ready to start using Synton AI.

Looking for something else? Browse all guides.