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 which Shopify variants belong in the same Peasy item family. For example, a single 12-oz bag, a 3-pack of the same bags, and a case of twelve might 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 — Link Shopify products to existing Peasy item families or variants instead of creating duplicates

See Matching External Items to Peasy Items for the statuses, grouping choices, and rules of thumb Peasy uses on this screen.

Choosing how items are grouped

Click Help above the staging table to open the Inventory Grouping Settings drawer and Beacon guidance. The drawer lets you 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 Example Only preview shows how external items would become Peasy item families and variants. Searching, filtering, or selecting rows narrows what the Save buttons include, 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 a Save button. The footer button changes scope based on what you're viewing or selecting, such as Save All, Save Page, or Save Selected. Peasy creates or links the items in your catalog with 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 (or skip selection to act on everything).
5. Click the footer Save button, or save individual rows and families as you review them.

Matching to Existing Items

If you've already added some items manually, Peasy can match Shopify products to them instead of creating duplicates. You can use AI suggestions or pick the Peasy item family or variant yourself.

For the full matching workflow, see Matching External Items to Peasy Items.

Undoing a Saved Import

Saved rows include row or family actions for cleanup:

• Unlink — Removes the Peasy import link so you can review and import the Shopify item again. The saved Peasy item is kept.

Use Unlink when the wrong Peasy item was created or linked, or when you need to move a saved row back into the editable import flow.

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 Inventory Grouping Settings. With Shared Inventory Pools (the default), Peasy suggests item families for variants that share one inventory pool. Switch to Separate Items when each variant should be its own Peasy item with its own count. See Matching External Items to Peasy Items for examples.

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
• Matching External Items to Peasy Items — Item families, grouping choices, and matching statuses
• Shopify Sync and Webhooks — Ongoing synchronization
• Understanding Items and Units — How units and conversions work