Skip to Content
ConceptsResources

Resources

A resource is a category of data that moves as one unit. Graftport supports nine today:

ResourceSource examplesNotes
Productcatalog items + variantsIncludes options, images, metafields. The richest mapping.
Customeraccounts, addressesPII; opt-in.
Collectionmanual + smart collectionsLinked to products by handle.
Discount codepromo codesMapped to Shopify price rules + discount codes.
Gift cardissued gift card balancesMoney; opt-in. Activated on Shopify side.
Orderhistorical orders + line itemsHeaviest resource. PII + money; opt-in.
Blogblog posts and articlesContent migration only — not theme.
Marketregional storesShopify Markets equivalents.
RedirectURL redirectsPath-based, source from → destination to.

Enabling a resource

Resources are enabled per migration, not globally. Enabling does three things:

  1. Adds the resource to the migration’s Resources list.
  2. Pins a mapping — either the current default template version or a tenant-owned fork.
  3. Tells future runs that this resource is part of the work to do.

Disabling later doesn’t delete the resource’s data — it just stops it being included in new runs. Re-enable to pick up where you left off.

Resource ordering at load time

When a load runs, Graftport pushes resources in a sensible default order: collections before products that reference them, customers before orders, and so on. You don’t pick the order — it’s enforced automatically.

If you start a run that only does extract or transform, the order doesn’t matter because nothing is written to Shopify.

Last updated on