If your Shopify CSV import is not working, it is usually caused by a small issue in your CSV file.
This guide helps you find and fix the most common problems.
Simple CSV shows a loading or processing message
Loading mapping fields… means the Mapping field list is still loading. Save and continue stays in a loading state until it is ready. Wait before continuing, especially with wide files or large XML feeds.
During a bulk operation, Simple CSV shows Shopify is processing your products. This may take a few minutes… There is no increasing counter. This message alone does not mean the import has stopped.
With AI Rewrite, you may see Preparing your product text… Large files can take several hours. Once the import starts, you can close the page and check progress later.
When an Import or Update uses AI Rewrite, its status page lists the fields being rewritten, target language and tone. It confirms brand voice and protected terms when set, without showing your answers or terms. Reload the page after the run finishes to see “were rewritten” instead of “are being rewritten”. When rewriting starts, the activity log adds one Info line with the same summary. Individual product lines do not list rewritten fields. With AI Rewrite off, neither the section nor the summary line appears.
A product could not be rewritten safely
After one automatic retry, that product is not imported or updated. The original text is never published in its place. Other products continue. Open the import log to find the product or row. Read the AI Rewrite guide for preview behavior and checks.
Start with a simple check
Before looking deeper, check the basics:
- Are all required columns included?
- Do the column names match Shopify exactly?
- Is your file saved as CSV (UTF-8)?
Many import issues are caused by small formatting mistakes.
Missing or incorrect columns
If a required column is missing, the import may fail.
To fix it:
- Use a Shopify export as a template
- Make sure column names match exactly
Variants not importing correctly
If variants are not set up correctly, products may be duplicated or missing options.
To fix it:
- Use the same handle for all variants of one product
- Make sure each variant has its own row
Images not importing
If images are missing, the image URLs may not be correct.
To fix it:
- Use a full image URL that starts with
https://or// - Make sure the images are publicly accessible
Simple CSV skips relative image paths such as /image/catalog/photo.jpg. The product still imports without that image, and the import log says: Skipping image "…" because relative paths are not supported. Use a full URL.
Barcodes (EAN/ISBN) are incorrect
Spreadsheet tools may change long numbers into scientific notation.
8712345678901→8.71235E+12
This breaks the barcode.
To fix it:
- Format the column as Text
- Or add an apostrophe before the number
Duplicates after a limited live run
On Pro and Scale, Run first 100 rows makes real Shopify changes. If you choose Import without checking SKU or barcode, a later full import creates the sampled products again. Check your settings for existing products before continuing. Full file dry run checks the whole file without changing Shopify. Read the limited live run guide.
Products are duplicated instead of updated
This usually happens when the handle does not match an existing product.
To fix it:
- Make sure the handle is exactly the same
- Check for extra spaces or differences in spelling
When to use a CSV import app
If you keep running into issues, a CSV import app can map non-Shopify headers before the import starts.
The Simple CSV Shopify app can:
- Map your columns to Shopify fields
- Preview five example rows before the import
- Update existing products with exact SKU, first barcode, handle or Shopify ID matches
Simple CSV compares SKU, handle and the first barcode exactly after ignoring letter case and surrounding spaces. Prefix matches do not update a product. If a Shopify variant has several barcodes, Simple CSV checks only the first one. A secondary barcode in the file does not match, so the row is skipped as not found. If an exact SKU or first barcode matches several products, the row is skipped and the import log reports how many products use that identifier. Use SKU or Shopify ID when you can.
Simple CSV held an action after columns changed
A hold stops the entire feed action before it changes Shopify products. Open the feed and choose Review mapping and resume. Map the affected fields to the right columns, or remove optional field mappings, then select Save mapping. Run now cannot clear a hold. The hold and its email are on every plan. Scheduling requires Pro or Scale. Files set to First row is not a header are not checked. Read the hold and mapping-review guide.
Scheduled import completed with zero counters
A Pro or Scale scheduled import may appear as Completed in the import history but show No changes in the file when you open it. This means Simple CSV found the same file and settings as the last fully successful scheduled run. It skipped the file without touching Shopify.
Open the automation and select Run now if you need to apply the same file again. Run now processes it unless the action is held for mapping review. This is useful when Shopify changed after the last run, such as when sales reduced inventory or someone deleted a product.
See what changed in Shopify
On Scale, including trials, open Run status → View run change history to compare values before and after a run. Browse confirmed changes without searching, or narrow them down by exact SKU, product name or Shopify product or variant ID. Values that stayed the same are not listed. History is kept for 90 days and cannot undo changes. Free and Pro do not include it. If Change history could not be loaded appears, select Try again or return with View run status. Separate notices cover a run still processing, incomplete history, history not recorded, a run older than 90 days and searches with no matches. If history may be incomplete, check the import log and the affected products in Shopify. Read how to use run change history.
Products were skipped by your selection
This is separate from other skipped rows. Check your Choose products conditions and the completed run’s Product selection section. If nothing matches, the run finishes without importing or updating products and shows a warning. If a condition column disappears, the run stops with a clear message and never processes the whole file instead. Read how selection conditions work.
More help
If you are not sure how your CSV should look, see Shopify CSV format explained.
The How to import products to Shopify using CSV guide covers the full workflow.
For detailed troubleshooting and Shopify’s full CSV field reference, read the complete Shopify CSV import guide.