Shopify Connector

Connect to Shopify stores for real-time product import

Overview

The Shopify connector allows you to import products directly from a Shopify store into your WooCommerce store. This enables real-time synchronization of product data, including prices, inventory, descriptions, images, and variants.

The connector uses Shopify's Admin API to fetch product data. You'll need to create a private app in your Shopify store and obtain the necessary API credentials.

Prerequisites

  • A Shopify store with admin access
  • Ability to create private apps in Shopify
  • PrimeLink installed and activated on your WooCommerce store

Setting Up Shopify Credentials

Step 1: Create a Private App in Shopify

  1. Log in to your Shopify admin panel
  2. Navigate to Settings → Apps and sales channels
  3. Scroll down and click Develop apps
  4. Click Create an app
  5. Enter an app name (e.g., "PrimeLink Import")
  6. Click Create app

Step 2: Configure API Permissions

After creating the app, configure its permissions:

  1. Click on Configure Admin API scopes
  2. Enable the following permissions:
    • Read products: Required to fetch product data
    • Read inventory: Required to fetch inventory levels
    • Read product listings: Optional, for additional product information
  3. Click Save

Step 3: Install the App

  1. Click Install app at the top of the page
  2. Confirm the installation
  3. The app will be installed and credentials will be generated

Step 4: Get API Credentials

After installation, you'll see the API credentials:

  1. Go to the API credentials tab
  2. You'll see:
    • API Key: Your Shopify API key
    • API Secret Key: Your Shopify API secret
    • Admin API access token: Your access token
  3. Copy all three values
⚠️ Important: The API Secret Key and Admin API access token are only shown once. Make sure to copy them immediately and store them securely.

Step 5: Get Your Shop Domain

Your shop domain is your store's URL without the protocol:

  • Example: If your store URL is https://your-shop.myshopify.com
  • Your shop domain is: your-shop.myshopify.com

Configuring PrimeLink

Step 1: Start a New Import

  1. Navigate to PrimeLink → Imports → New Import
  2. Select the import type (e.g., Products)
  3. Click Next to proceed to Step 2

Step 2: Select Platform Source

  1. In Step 2, select Import from Platform (Real-time)
  2. Choose Shopify from the platform dropdown

Step 3: Enter Credentials

Fill in the Shopify connection form:

Required Fields

  • Shop Domain: Your Shopify shop domain (e.g., your-shop.myshopify.com)
  • API Key: The API key from your Shopify private app
  • API Secret: The API secret key from your Shopify private app
  • Access Token: The Admin API access token from your Shopify private app

Step 4: Test Connection

  1. Click the Test Connection button
  2. PrimeLink will attempt to connect to your Shopify store
  3. If successful, you'll see a confirmation message
  4. If it fails, verify your credentials and shop domain

Step 5: Continue with Import

After a successful connection test:

  1. Click Next to proceed
  2. PrimeLink will fetch products from Shopify
  3. Continue with the rest of the import wizard (mapping, options, etc.)

How Shopify Import Works

Product Fetching

PrimeLink uses Shopify's Admin API to fetch products:

  • Products are fetched in batches (up to 250 per request)
  • Uses since_id for pagination (more efficient than page-based)
  • Fetches all product variants, images, and metadata

Data Mapping

Shopify product data is automatically mapped to WooCommerce fields:

  • Title: Product title
  • Description: Product description (HTML)
  • Price: Variant price
  • SKU: Variant SKU
  • Inventory: Inventory quantity
  • Images: Product images
  • Variants: Product variants

Incremental Updates

For scheduled imports, PrimeLink tracks the last imported product ID and only fetches new or updated products, making subsequent imports faster.

Troubleshooting

Connection Failed

  • Verify shop domain is correct (no https://, no trailing slash)
  • Check that all credentials are correct (no extra spaces)
  • Ensure the private app is installed and active
  • Verify API permissions are set correctly

403 Forbidden Error

  • Check that the app has the required permissions (Read products, Read inventory)
  • Verify the access token is correct
  • Ensure the app is not revoked or deleted

No Products Returned

  • Verify products exist in your Shopify store
  • Check that products are published (not draft)
  • Ensure the API has permission to read products

Rate Limit Errors

  • Shopify has rate limits (typically 2 requests per second)
  • PrimeLink automatically handles rate limiting with delays
  • For large imports, consider scheduling them during off-peak hours

Best Practices

  • Use dedicated private apps: Create separate apps for different purposes
  • Minimal permissions: Only grant the permissions you need
  • Secure credentials: Store API credentials securely, never share them publicly
  • Test first: Always test the connection before running a full import
  • Schedule imports: Use scheduling for regular synchronization
  • Monitor rate limits: Be aware of Shopify's API rate limits for large stores

Next Steps

📥 Creating Imports

Learn the complete import process with field mapping

Learn More →
⏰ Scheduling

Set up automatic recurring imports from Shopify

Learn More →