Bulk Product Import

Bulk Product Import

If you have a large catalog or are migrating from another platform, the bulk import feature lets you add dozens or hundreds of products at once using a CSV file.

Preparing Your CSV File

Create a CSV (comma-separated values) file with the following columns:

• title — Product name (required).
• handle — URL slug (auto-generated from title if left blank).
• description — Product description (HTML supported).
• variant_title — Variant label (e.g., "Small", "Blue").
• variant_price — Price in cents (e.g., 2999 for $29.99).
• variant_sku — SKU code for inventory tracking.
• variant_inventory_quantity — Stock count.
• image_url — Public URL for the product image.
• weight — Product weight in grams (for shipping calculations).

Save the file with UTF-8 encoding to preserve special characters.

Importing Products

1. Go to Products in the admin sidebar.
2. Click the "Import" button in the top-right corner.
3. Select your CSV file and upload it.
4. Nuvi displays a field mapping preview — verify that each column maps to the correct product field.
5. Click "Start Import". A progress bar shows the status.
6. Review the import summary for any errors or skipped rows.

Migrating from Other Platforms

From Shopify

Shopify allows you to export products as CSV from Products > Export in the Shopify admin. The Nuvi importer recognizes Shopify's CSV format and maps fields automatically. You may need to adjust variant pricing (Shopify uses decimal dollars, Nuvi expects cents).

From WooCommerce

In WooCommerce, go to Products > Export and select CSV format. The column names differ slightly from Nuvi's format — use the field mapping step to match them. Common mappings:

• post_title → title
• regular_price → variant_price (convert to cents)
• stock → variant_inventory_quantity

Troubleshooting Import Errors

• "Duplicate handle" — Two rows have the same slug. Make each handle unique.
• "Invalid price" — Ensure prices are whole numbers in cents, not decimal strings.
• "Image not found" — The image URL must be publicly accessible. Private or expired URLs will fail.
• Encoding issues — If special characters appear garbled, re-save your CSV as UTF-8.