Importing from Shopify

IntegrationsUpdated August 19, 2026 · Reviewed by Peasy Team

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

Open the ⋮ menu above the staging table and choose Inventory grouping. Choose how Shopify variants should save into Peasy:

  • Shared Inventory Families (default) — Group items into families to share the same inventory pool. 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.

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 a family's grouping and settings, click Save family in its header. Select some variants in that family first when you only want to save that subset; the button changes to Save N variants. Use Exclude variant for source variants you do not want to save yet—you can restore them later. The footer's Save N Families button saves the ready families on the currently loaded page; move through additional pages to review and save those families. Peasy creates or links the items in your catalog with the right units, conversions, and links back to Shopify.

Each new variant needs a unit before it can be saved. Until you choose one from its unit selector, that variant shows a placeholder and Save family stays disabled with a prompt to pick a unit (or exclude the variant). Variants matched to an existing Peasy item inherit that item's unit, so they don't need a choice.

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.

Units and Pack Sizes on Imported Variants

By default, each Shopify variant comes into Peasy as its own unit at a one-to-one conversion — Peasy uses the Shopify variant title as the unit label (or "each" when it has none) and treats it as its own base unit.

When you group variants that share stock (Shared Inventory Pools), Peasy tries to set the right conversion for you. It can detect a pack size when the Shopify variant title or an option clearly states it — for example "Pack of 6," "Case of 12," "3-pack," or "12 ct" — and sets the conversion automatically (e.g., 1 case = 12 each).

What it can't do on its own: if nothing in the variant's title or options says how many units are in the pack, Peasy can't tell a case from a single each, so it leaves that variant at a one-to-one conversion. That can make a case look like a single unit and throw off your counts.

So always check the Set units and conversions step during review and fix any variant whose pack size wasn't detected — set how its unit converts to the family's Inventory Unit. You can also adjust a variant's unit and conversion later on the item itself.

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.

More than one Shopify variant can match the same Peasy sell variant. Use this when the Shopify variants are different storefront listings for the exact same unit and inventory pool—for example, retail and wholesale listings that both represent one case. Peasy keeps each Shopify link separate, so you can see every mapping and unlink one listing without unlinking the others.

Do not use one shared Peasy variant when the Shopify listings represent different pack sizes or conversions. In that case, create or select separate Peasy variants inside the same family.

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. If several Shopify variants map to the same Peasy variant, unlinking one does not disturb its sibling mappings.

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 choice in Inventory grouping. With Shared Inventory Families (the default), Peasy groups related variants into families 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

Was this article helpful?