From Admin > Inventory > Import Catalog you can import your product catalogue from a CSV file.
How It Works
- Prepare your CSV file (see column reference below).
- Upload the file in the Import Catalog section.
- Use the dropdown menus to map each CSV column to the correct CubeCart field.
- If your column headers match the names in the table below, CubeCart maps them automatically.
CSV Column Reference
| Column Header | Description | Required |
|---|---|---|
name |
Product name | Yes |
price |
Product price | Yes |
cat_id |
Category ID(s) — separate multiple with commas | Recommended |
product_code |
SKU / product code | No |
description |
Product description (HTML supported) | No |
stock_level |
Quantity in stock | No |
stock_warning |
Low stock warning threshold | No |
digital |
Digital product (1 = yes, 0 = no) | No |
digital_path |
Path to digital download file | No |
sale_price |
Sale/discounted price | No |
cost_price |
Cost price (for profit tracking) | No |
weight |
Product weight | No |
product_weight |
Alternative weight field | No |
upc |
UPC / barcode | No |
ean |
EAN code | No |
jan |
JAN code | No |
isbn |
ISBN code | No |
gtin |
Global Trade Item Number | No |
mpn |
Manufacturer Part Number | No |
brand |
Manufacturer / brand name | No |
condition |
Product condition (new, refurbished, used) | No |
popularity |
Popularity score (affects sort order) | No |
featured |
Featured product (1 = yes) | No |
seo_path |
Custom SEO URL slug | No |
main_image |
Primary product image filename | No |
extra_images |
Additional images (semicolon-separated filenames) | No |
tax_type |
Tax class ID | No |
tax_inclusive |
Price includes tax (1 = yes) | No |
status |
Product status (1 = enabled, 0 = disabled) | No |
Importing Images
For the image columns to work, upload your product images to the images/source/ directory first (via FTP or file manager). Then reference the filenames in your CSV.
For extra_images, separate multiple filenames with semicolons: image1.jpg;image2.jpg;image3.jpg
Updating Existing Products
If your CSV contains a product_id or product_code column that matches existing products, CubeCart will update those products rather than creating duplicates.
Tips
- Start with a small test import (5–10 products) to verify your mapping is correct.
- Save your CSV in UTF-8 encoding to avoid character issues.
- Use a spreadsheet application (Excel, Google Sheets, LibreOffice Calc) to prepare your CSV.
- For large imports (thousands of products), increase PHP
max_execution_timeandmemory_limit. - Back up your database before importing.