Back to Help Center
Category: Troubleshooting

Common Issues and Solutions

Solutions to common problems you might encounter when using ExpressCSV

File Size Limits

If you're having trouble uploading a CSV file, check that it doesn't exceed our size limits:

  • Free plan: Up to 5MB
  • Pro plan: Up to 25MB
  • Enterprise plan: Up to 100MB
File Size Limits

Encoding Problems

For CSV files with special characters:

  1. Ensure your CSV is saved with UTF-8 encoding
  2. If using Excel, export as "CSV UTF-8"
  3. Check for and remove any BOM (Byte Order Mark) characters

Step-by-Step Troubleshooting Guide

1

Ensure you have a stable internet connection. You can test your connection by visiting other websites or using a speed test tool.

// Example code can be included
console.log('Connection test');
2

Make sure your file is a valid CSV format:

  • Check for proper delimiters (commas or tabs)
  • Ensure all rows have the same number of columns
  • Remove any special formatting or macros
3

Sometimes cached data can cause issues:

  1. Open your browser settings
  2. Navigate to privacy/security settings
  3. Clear browsing data (focus on cached images and files)
  4. Try uploading again
4

If you're still experiencing issues, our support team is ready to help:

  • Email: support@expresscsv.com
  • Live chat: Available during business hours
  • Include screenshots and descriptions of the issue

Widget Integration Issues

Widget Not Appearing

If the widget isn't appearing in your application:

// Check if the container element exists
if (!document.querySelector('#csv-container')) {
  console.error('Container element not found');
}

// Make sure you're calling widget.open() after the DOM is loaded
document.addEventListener('DOMContentLoaded', () => {
  widget.open();
});

CORS Errors

If you're seeing CORS errors in the console:

  1. Ensure your domain is added to the allowed origins in your project settings
  2. Check that you're using the correct API key
  3. Verify that your browser supports the required features

Data Mapping Issues

If columns aren't mapping correctly:

  1. Check that your column headers match your schema field names
  2. Try using our auto-mapping feature by clicking "Auto Map"
  3. Ensure your CSV doesn't have extra header rows or comments at the top

Still having issues? Contact our support team for assistance.