How to Connect a Shopify Store
Step-by-step guide to connect your Shopify store to Atri AI Search for powerful product search capabilities.
What You'll Need
- Admin access to your Shopify store
- Your Shopify store URL (your-store-name.myshopify.com)
- A private app access token with read permissions
- Products in your Shopify store to index
Configuration Steps
Step 1: Create a Private App in Shopify
Set up a private app in your Shopify admin to generate API credentials.
- Log into your Shopify admin panel
- Navigate to 'Apps' in the main menu
- Scroll down and click 'App and sales channel settings'
- Click 'Develop apps' then 'Create an app'
- Give your app a name (e.g., 'Atri AI Search')
Step 2: Configure API Permissions
Set up the necessary permissions for the private app to access your product data.
- Go to the 'Configuration' tab in your new app
- Under 'Admin API scopes', enable the following permissions:
- • read_products (Products) - Access to product information
- • read_product_listings (Product listings) - Access to product catalog
- • read_inventory (Inventory) - Access to stock levels
- Click 'Save' to apply the permissions
Step 3: Install the App and Get Access Token
Install the private app and retrieve your access token.
- Click 'Install app' to activate the private app
- Once installed, you'll see the 'Admin API access token'
- Copy the access token and store it securely
- Note: This token provides direct access to your store data
Step 4: Configure in Atri AI Search
Enter your Shopify credentials in the AI Search configuration.
- Navigate to your AI Search project dashboard
- Go to the data sources configuration section
- Select 'Connect Shopify Store' as your data source
- Enter your store name in the format: your-store-name.myshopify.com
- Paste your access token in the Access Token field
Step 5: Connect and Process Data
Initiate the connection and let the system process your product data.
- Click 'Connect Shopify Store' to start the process
- The system will connect to your store and retrieve product data
- Wait for the processing to complete (typically takes a few minutes)
- You'll see a success message when data retrieval is finished
Step 6: Review Detected Fields
Verify that your product fields have been correctly identified.
- Review the list of fields detected from your products
- Common fields include: title, description, price, tags, variants
- These fields will be available for search configuration
- You can proceed to configure search settings with these fields
Important Notes
- Your access token should be kept secure and never shared publicly
- Only enable the minimum required permissions for security
- The system will automatically sync product updates from your store
- Processing time depends on the number of products in your store
- You can edit or update your connection settings at any time
Common Issues
Connection failed
- Verify your store URL is correct (include .myshopify.com)
- Check that your access token is valid and has the required permissions
- Ensure your store is accessible and not in maintenance mode
- Try regenerating your access token if the current one isn't working
No products found
- Verify you have published products in your Shopify store
- Check that the read_products permission is enabled
- Ensure products are not restricted by sales channels
- Try reconnecting after adding products to your store
Processing takes too long
- Large product catalogs may take several minutes to process
- Check your internet connection stability
- Wait for the process to complete before making changes
- Contact support if processing exceeds 30 minutes