Who This Is For / When to Use
Use CSV product import if you need to:
Add many products at once.
Create products with multiple variants.
Update pricing, inventory, or SEO fields in bulk.
Migrate products from another system.
Before You Start
You must have:
Access to Payments > Products.
A properly formatted CSV file.
The Kyrios sample CSV file for reference.
Step 1: Open the Products Page
Go to Payments.
Click Products.
Step 2: Start the CSV Import
Click Import as CSV.
Step 3: Download the Sample CSV
In the import modal, click Download sample CSV.
Use this file as the required format reference.
Step 4: Prepare Your CSV File
Edit the sample CSV or create a new CSV using the same structure.
Core Product Fields
Handle – Unique product identifier (required).
Title – Product name.
Body (HTML) – Product description.
Image Src – Public image URL.
Variant Fields
Option Name / Option Value – Variant attributes (example: Size / M).
Variant Price – Selling price.
Variant Compare Price – Original price (optional).
Supported Advanced Fields
Inventory
Track Inventory (TRUE / FALSE)
Allow out-of-stock purchases (TRUE / FALSE)
Available quantity
SKU
Shipping
Weight value
Weight unit (kg, g, lb, oz)
Dimension length, width, height
Dimension unit (cm, m, in)
Product Labels
Enable product label (TRUE / FALSE)
Label content
Start date (ISO format)
End date (ISO format)
SEO
SEO Title
SEO Description
Step 5: Upload and Preview
Click Click to upload or drag and drop your CSV file.
Click Upload & Preview.
If errors appear, fix them in the CSV and re-upload.
Step 6: Review Import Preview
Preview the first product and its variants.
Confirm pricing, inventory, and labels.
Click Import Products.
Step 7: Monitor Import Progress
A progress modal shows the import status.
You can close the modal safely.
An email confirmation is sent when complete.
After Import Completion
Products appear in Payments > Products.
Variants, prices, and inventory are created automatically.
Common Issues and Fixes
CSV Upload Fails
Ensure the file is saved as
.csv.Confirm all required columns exist.
Products Not Updating
Verify SKUs or Handles match existing products.
Ensure you are not creating duplicate Handles.
Images Not Importing
Image URLs must be public and accessible.
Do not upload local file paths.
FAQ
How do I download the sample CSV?
Click Import as CSV and select Download sample CSV from the upload modal.
Can I update existing products using CSV?
Yes. Keep the same Handle or SKU to update existing products.
What happens if there are errors in my CSV?
The preview screen displays exact errors. Fix them and re-upload the file.
Is there a file size limit?
Large files may take longer to process. Split very large imports if needed.
How do I add product images via CSV?
Provide a public image URL in the Image Src column. Images are downloaded automatically.
Can I import variants and pricing together?
Yes. Each row represents a variant with its own pricing and options.
Who should I contact if my import fails?
Contact Kyrios Support if errors persist after correcting the CSV format.