Glossary

Term	Meaning
Tenant	The org that owns a set of migrations, mapping forks, and credentials. Every user belongs to one tenant.
Migration	The long-lived workspace representing one merchant’s move.
Source platform	The system the merchant is migrating away from (Magento, Shopify-as-source).
Destination	The Shopify store the merchant is migrating into.
Resource	A category of data being moved (product, customer, order, …).
Run	One execution of one or more phases.
Run item	The per-resource record inside a run; carries phase, result, counts, errors.
Phase	Extract, transform, or load — the three steps of a run.
Extract	Pulling rows from the source platform into Graftport.
Transform	Running the JSONata mapping over the extracted data, producing Shopify-shaped records.
Load	Pushing the staged records to Shopify.
Extracted data	The faithful copy of source rows as the source returned them.
Staged record	A Shopify-shaped payload, ready to load.
Pending	A staged record whose payload hasn’t yet landed on Shopify (or has changed since last load).
Mapping	The link between a `(migration, resource)` pair and a specific mapping version.
Mapping template	A named recipe scoped to a source platform + resource type. Default templates are global; forks belong to your tenant.
Mapping version	An immutable snapshot of the JSONata text.
JSONata	The JSON query and transformation language used for mappings. See jsonata.org .
Conflict strategy	What load does when a record already exists on Shopify — overwrite or skip.
Only-dirty	Run-time toggle that limits load to records with pending changes.
Field filter	Run-time filter that restricts which fields a load updates per resource.
Dry run	A run mode that does the work but doesn’t write the result anywhere.
Resync locations	A button that re-pulls Shopify locations for the destination store, used before splitting inventory.