Why is my import failing?

Please ensure the following items before you import a file:

1. Always use CSV or VCF (for contacts), depending on the module.
2. Verify that the file is UTF-8 encoded to prevent unexpected characters (especially for names with accents or special symbols).
3. Make sure column headers are on the first row.
4. The size of the local file that you are importing must not exceed 50 MB.
5. Ensure that each column in your file is correctly mapped to a Vtiger field during the import process. Especially the mandatory fields.
6. Avoid duplicate or mismatched field names—stick to clear, unique headers.
7. Remove extra spaces, commas, or hidden characters in your CSV.
8. Confirm you have Import permission for that module in your role/profile.
9. If you don’t see the Import option, ask the CRM admin to enable it.
10. Ensure picklist values in your file match exactly with the ones in Vtiger (case-sensitive)
11. For lookup fields (such as linking a Contact to an Account), ensure the referenced record already exists in Vtiger.
12. After import, check the error file download link. It lists the rows that failed and provides the reason (missing fields, invalid format, duplicates, etc.).

For more information, contact our support team at [email protected].