Getting Started Tutorial

Install StoreSync Hub from the Shopify App Store on your main (master) store. This is the store that will be the source of truth for all product data and inventory levels.

Choosing your master store

• Your master store should be the one where you primarily manage products.
• All changes made on the master store will automatically push to connected secondary stores.
• Changes made on secondary stores will not sync back to the master.

After installing, open StoreSync Hub from your Shopify admin. On the homepage, you'll see the "Create new connection" section.

1. Click Create to generate a unique Connection ID.
2. Note down the Connection ID — you'll need this for each secondary store.
3. Your master store is now ready and waiting for secondary stores to connect.

Install StoreSync Hub on each secondary store, then join the connection:

1. Open the app on the secondary store.
2. In the "Join existed connection" field, enter the Connection ID from Step 2.
3. Click Join.
4. The store will appear in the Store Connections table on all connected stores.

Tip: Repeat this for as many secondary stores as you need. There's no limit on the number of connected stores.

Navigate to Settings to customize what gets synced:

Products Sync

• Toggle product sync on/off.
• Choose the sync entity (SKU or Barcode) for matching products across stores.
• Select which product fields to sync: Title, Description, Images, Prices, Tags, SEO, and more.
• For each field, choose: Every Update, Upon Creation Only, or Never.

Inventory Sync

• Toggle inventory sync on/off.
• Configure location mapping strategy (Default, Name-based, or Custom).
• Enable Safety Net for daily automatic inventory verification.

Collections Sync

• Toggle collections sync on/off.
• Choose which collection fields to sync (title, description, image, sort order, products, metafields).

Exclusions

• Add tags to exclude specific products from product sync.
• Add tags to exclude specific products from inventory sync.

Sync Rules give you advanced control over how data is transformed during sync.

Filter Rules

Block products from syncing based on conditions. Example: skip all products where product type equals "Gift Card".

Transform Rules

Modify data during sync. Common use cases:

• Regional pricing: Multiply price by 1.10 to add a 10% markup for EU stores.
• Tag management: Append a region tag like "synced-from-us" to all synced products.
• Text replacement: Replace "Free shipping in US" with "Free shipping in EU" in descriptions.
• Status control: Set synced products to "draft" status for review before publishing.

Note: Rules are executed by priority (lowest number first). Filter rules that block a product will prevent any subsequent transform rules from running.

Open the Sync Dashboard to monitor sync activity in real-time:

• Stats cards: See total syncs, success rate, and failure count for the last 24 hours and 7 days.
• Sync by type: Breakdown of product creates, updates, deletes, inventory updates, and collection updates.
• Sync history: Detailed log of every sync operation with type, status, product name, duration, and error messages.
• Filters: Filter the history by sync type and status to quickly find issues.

Tip: If you see failed syncs, check the error message column for details. Common issues include missing SKUs, API rate limits, or network timeouts.