magmi import not found

magmi import not found

October 9, 2026 · Illustrated author avatarBy Stefan Bogdanescu
magmi import not found

Solving the “Magmi Import Not Found” Error

You’re not alone if you’ve encountered the “not found” error while using the Magmi extension for bulk category or product imports in Magento. This issue is quite common, especially when working with complex CSV files. In this post, we’ll diagnose the problem and provide a step-by-step solution to help you resolve it.

Understanding the Error Message

The error message:

not found
/plugins/base/datasources/csv/magmi_csvdatasource.php:121 - Magmi_CSVReader->checkCSV
----------------------------------------

indicates that Magento is unable to locate or process your CSV file correctly during the import process. This usually happens when there’s an issue with the structure, encoding, or path of your data file.

Identifying Common Causes

Before we proceed, let me briefly outline some common reasons for this error:

  1. Incorrect File Path: Ensure that you’ve uploaded the CSV file to the correct directory (usually media/import) and that the path is specified correctly in your import configuration.

  2. CSV Structure Issues: Check if your CSV file follows Magento’s expected format, including proper headers, column names, and data types for each field.

  3. Encoding Problems: If your CSV uses special characters or non-ASCII text, ensure it’s saved using a compatible encoding like UTF-8.

  4. PHP Permissions: In some cases, insufficient file permissions can prevent Magento from reading the CSV file.

Solving the “Not Found” Error

Now let me guide you through an effective troubleshooting process:

Step 1: Validate Your CSV File Format

First, ensure your CSV file adheres to the following best practices:

  • Use a consistent delimiter (usually comma or semicolon).
  • Ensure each row represents one record and contains all required fields.
  • Double-check that the field names match Magento’s expectations.

You can use an online validator like [https://www.laverna.cc/validate-csv] to quickly check your file.

Step 2: Verify File Encoding

Right-click on your CSV file, select Properties, and navigate to the General tab. Check if the encoding is set to ‘UTF-8 without BOM’. If not, save a new version with this encoding.

Step 3: Check File Permissions

Ensure that your Magento user has the necessary permissions to read files in the media/import directory. You can use chmod (e.g., chmod -R 755 media) or contact your system administrator for help if needed.

A Real-World Example

Suppose you’re trying to import a category CSV file named categories.csv. Here’s an example of what the file structure should look like:

sku,name,description
1,Category 1,This is Category 1
2,Category 2,This is Category 2

Make sure:

  • The header row matches Magento’s required fields.
  • Each subsequent line represents a single category.
  • The CSV uses UTF-8 encoding without BOM.

Conclusion

Resolving the “not found” error often involves careful attention to your CSV file structure and permissions. By validating your data, checking encoding, and verifying file access rights, you can usually eliminate this issue quickly.

Remember, Magmi is a powerful tool, but it relies on well-formed data to function correctly. Always ensure that your import files follow Magento’s guidelines and double-check any custom field mappings before proceeding with an import.

If you’re still having trouble, feel free to explore our comprehensive guide on magento bulk imports for more in-depth tutorials and best practices.

Catalog Security Extensions Configuration

Our network