CSV Import Troubleshooting
Resolve issues importing table rate CSV files.
Common Issues
Import Fails
Symptoms:
- Error message on upload
- Rates not appearing
Solutions:
- Check CSV format (UTF-8, no BOM)
- Verify column headers match exactly
- Check for empty rows
- Remove special characters
Bulkgood Column Ignored
Symptoms:
- CSV imports but bulkgood not working
Solutions:
- Column must be named exactly "Bulkgood"
- Values must be 0 or 1 (not Yes/No)
- No spaces in column name
Wrong Rates Applied
Symptoms:
- Rates don't match CSV values
Solutions:
- Clear config cache after import
- Check store view scope
- Verify condition column values
- Check for duplicate rows
CSV Format Requirements
Country,Region,Zip,Condition,Price,Bulkgood| Column | Format | Example |
|---|---|---|
| Country | ISO 2-letter | DE, US, * |
| Region | Code or * | BY, CA, * |
| Zip | Pattern or * | 80*, 90210, * |
| Condition | Numeric | 0, 10, 100 |
| Price | Decimal | 25.00 |
| Bulkgood | 0 or 1 | 1 |
Validation
Before import:
- Open in text editor (not Excel)
- Check encoding is UTF-8
- Verify no hidden characters
- Test with small file first
