Importing from Shopify

After connecting your Shopify store, the next step is importing your products into Peasy. You don't have to import everything at once — pick and choose what you need, and come back for more later.

How to Get There

Click Configure (gear icon) in the sidebar, select Integrations, then open Shopify. After you sync products, review them on the Products tab.

How the Import Works

The import happens in three stages:

1. Sync

Peasy pulls your latest product data from Shopify. This brings in product names, variants, prices, images, and inventory levels.

2. Review and Group

Your Shopify products appear in a staging area where you can:

• Review items — See what's coming in from Shopify
• Group variants — Peasy uses AI to suggest how to group your Shopify variants into item families. For example, a single 12-oz bag, a 3-pack of the same bags, and a case of twelve might be grouped under "Light Roast — 12 oz Bag" since they share one inventory pool.
• Set units and conversions — Define what unit each variant represents and how they convert to the family's Inventory Unit
• Assign categories — Organize items into your Peasy categories
• Match to existing items — If you already have items in Peasy, you can link Shopify products to them instead of creating duplicates

The staging area uses badges to show what will happen:

• New — This Shopify variant will create a new Peasy item when imported.
• Linked — This Shopify variant will connect to an existing Peasy item.
• Imported — This item or family has already been imported.
• Imported · pending — Some rows in the family are already imported, while others still need review.

Choosing how items are grouped

Click How it works above the staging table to choose how Shopify variants come in:

• Shared Inventory Pools (default) — Variants of the same Shopify product share one Inventory Unit and roll up into a single Peasy family. Best when "12-oz bag" and "case of twelve" should draw from the same stock.
• Separate Items — Each variant becomes its own Peasy item with its own count. Best for distinct products that just happen to be variants in Shopify, like different T-shirt colors or sizes.

The choice affects what Import All, Import Page, and per-row imports actually create — the staging table previews exactly what you'll get. Searching or filtering the table also narrows what those buttons import, so you can scope an import to just the rows you can see.

3. Import

Once you're happy with the grouping and settings, click import. Peasy creates the items in your catalog with all the right units, conversions, and links back to Shopify.

If Peasy needs to create a new family during import and something is missing, use the Create new family retry action after fixing the family name, units, category, or mappings.

Step by Step

1. Go to Configure > Integrations > Shopify.
2. Click Sync to pull the latest products from your store.
3. Review the staging area — adjust groupings, units, and categories as needed.
4. Select the items you want to import.
5. Click Import to create them in Peasy.

Matching to Existing Items

If you've already added some items manually, Peasy can match Shopify products to them:

• AI suggestions — Peasy suggests matches based on names and descriptions
• Manual matching — You can manually link a Shopify product to an existing Peasy item

Matched items get linked rather than duplicated — so inventory stays accurate.

Undoing or Stopping Sync

Imported rows include row or family actions for cleanup:

• Undo import — Removes the Peasy import link so you can review and import the Shopify item again.
• Stop Shopify sync — Keeps the Peasy item but disconnects it from ongoing Shopify product sync.

Use Undo import when the wrong Peasy item was created or linked. Use Stop Shopify sync when the item should stay in Peasy but no longer follow Shopify updates.

Common Questions

Will importing overwrite my existing items? No. Peasy matches incoming Shopify products by SKU. Unmatched products create new items, while matched products are linked to your existing Peasy items. Nothing gets deleted or overwritten.

How often does Shopify sync run? Shopify sends real-time webhooks for product and order updates, so changes are reflected quickly. You can also trigger a manual sync from the Shopify settings page for a bulk refresh. See Shopify Sync and Webhooks for details.

Can I import only some products from Shopify? Yes. After syncing, your products appear in a staging area where you review and select which items to import. You can skip anything you don't need and come back for it later.

What happens to Shopify variants? It depends on the grouping choice in How family groupings work. With Shared Inventory Pools (the default), Peasy uses AI to suggest how to group variants under parent items — for example, grouping "Coffee - 12oz" and "Coffee - 5lb" under "Coffee" so they share one inventory pool. Switch to Separate Items when each variant should be its own Peasy item with its own count.

Does importing affect my Shopify store? No. The import is read-only from Shopify to Peasy. Your Shopify products, inventory levels, and store settings are not changed during import.

Does importing bring in Shopify inventory counts? It can. If Shopify-to-Peasy inventory sync is enabled when you import, Peasy can use Shopify counts as starting inventory for new items. If Shopify-to-Peasy inventory sync is off, Peasy creates or links the items without adopting Shopify's current counts.

Good to Know

• Imports are partial — You don't have to import everything. Import what you need now and come back for the rest later.
• Import is non-destructive — It creates new items or links to existing ones. Nothing gets deleted.
• Prices and images from Shopify are carried over during import.
• After import, linked items follow the inventory sync direction you choose in Shopify settings. See Shopify Sync.

Related

• Connecting Shopify — Initial connection setup
• Shopify Sync and Webhooks — Ongoing synchronization
• Understanding Items and Units — How units and conversions work