Carien CSV Import Suite for WooCommerce allows your WooCommerce store to import customers, orders, and coupons directly from CSV files, using a clean admin interface with field mapping, validation, and detailed logs.
Installation
↑ Back to topTo start using a product from WooCommerce.com, you can use the “Add to store” functionality on the order confirmation page or the My subscriptions section in your account.
- Navigate to My subscriptions.
- Find the Add to store button next to the product you’re planning to install.
- Follow the instructions on the screen, and the product will be automatically added to your store.
Alternative options and more information at:
Managing WooCommerce.com subscriptions.
Setup and Configuration
↑ Back to topGetting Started
↑ Back to topTo set up your store with Carien CSV Import Suite for WooCommerce:
- Go to:
WooCommerce > CSV Import Suite - Tick the checkbox to Enable CSV Import Suite.
- Enter a description for your import section (optional).
- Save changes.
Once enabled, three import tools will appear:
- Import Customers
- Import Orders
- Import Coupons
Each tool includes its own CSV upload area, field mapping screen, validation step, and import log viewer.
Advanced configuration
↑ Back to topThe plugin offers multiple configuration options to fine-tune your import process:
1. Field Mapping
↑ Back to topEach import type includes a mapping interface where you match your CSV columns with WooCommerce fields:
- Automatically detects CSV headers.
- Allows manual mapping for custom column names.
- Required fields are highlighted to avoid mistakes.
2. Data Validation
↑ Back to topBefore importing, the plugin validates your CSV:
- Missing required fields
- Invalid email formats
- Incorrect order totals
- Missing coupon amounts
- Duplicate user emails
Validation prevents bad data from entering your store.
3. Import Logs
↑ Back to topEvery import generates a detailed log:
- Number of imported rows
- Warnings
- Errors
- Skipped entries
- IDs of created customers, orders, or coupons
Logs remain accessible for future reference.
4. CSV Templates
↑ Back to topThe plugin includes sample CSV templates for:
- Customers
- Orders
- Coupons
These ensure that you’re using the correct structure for a smooth import.
5. HPOS Compatibility
↑ Back to topThe plugin fully supports WooCommerce High-Performance Order Storage (HPOS).
Usage
↑ Back to topAdmin Usage (Backend)
↑ Back to top1. Importing Customers
- Upload a CSV containing customer data.
- Map each column (email, name, address, etc.).
- Validate and import.
- New users are created automatically with proper WooCommerce metadata.
2. Importing Orders
- Upload CSV containing order information.
- Map fields such as product IDs, totals, taxes, billing data, and statuses.
- The plugin creates WooCommerce orders with correct line items and totals.
3. Importing Coupons
- Upload a CSV containing coupon codes with amounts, types, and restrictions.
- Map coupon data fields.
- The coupons are added to WooCommerce and ready for use.
Front-End (Customer View)
↑ Back to topThis plugin does not display anything on the front end.
It is an admin management tool only.
Customers will only notice:
- Imported orders appear in their “My Account”
- Imported coupons are usable during checkout
- Imported accounts can log in normally
Troubleshooting
↑ Back to top1. My CSV import fails
Common causes:
- Missing required fields
- Wrong CSV encoding (use UTF-8)
- Incorrect date formats
- Invalid product IDs for orders
Check the import log for error details.
2. HPOS-related errors
↑ Back to topIf orders are not importing:
- Ensure HPOS is enabled and configured correctly
- Confirm that product IDs exist in your store
3. Large CSV files time out
↑ Back to topSolutions:
- Split the CSV into smaller parts
- Increase PHP memory limit
- Increase max_execution_time
- Ensure your hosting allows large file uploads
4. Duplicate email during customer import
↑ Back to topIf a customer already exists:
- The plugin will skip the entry
- The log will indicate the duplicate row
5. Blank screen or error during upload
↑ Back to topCheck:
Hosting max upload file size
File is in CSV format
No unsupported characters
FAQs
↑ Back to topHelp customers by answering commonly asked questions.
What types of data can I import with this plugin?
You can import Customers, Orders, and Coupons. These are the core WooCommerce objects supported by the plugin, and each has its own dedicated CSV import tool.
Does the plugin offer field mapping for custom CSV structures?
Yes. The plugin provides a smart field-mapping interface that lets you match your CSV columns with WooCommerce fields, even if your CSV uses custom or unconventional column names.
Does the plugin include sample CSV templates?
Absolutely. The plugin ships with ready-to-use CSV templates for customers, orders, and coupons so you can format your imports correctly right from the start.
