Changelog

Follow up on the latest improvements and updates

v2.7.0

Dec 18th, 2025

This release introduces Usage Analytics and File Insights for the plans Growth and Scale. This is an opt-in feature that can be enabled via the `enableImportMetrics` prop. Once enabled, it provides insights about the files imported, such as number of records, file size, and performance metrics.

v2.6.2

Dec 3rd, 2025

This release makes Excel import available in both the demo and trial packages, allowing you to test Excel workflows without requiring a full subscription.

v2.6.1

Nov 23rd, 2025

This release introduces the Boolean Data Provider, which provides Yes/No options for boolean fields with translatable labels.

It also improves the support for Excel headers, allowing to select how many rows the header should include. Default is one, but two rows can be selected from the dropdown when uploading an Excel file.

v2.6.0

Nov 9th, 2025

This releases introduces the concept of aliases for fields, which can be used to provide alternative names for fields when mapping columns from the uploaded file.

In addition, a new prop called fieldsProcessor has been introduced to allow you to manage fields dynamically. More details about this new prop can be found in the documentation.

It also expands how the field mapping works by providing additional context like details about the file uploaded.

Last, it addresses a usability issue with the pulse animation on the initial screen.

v2.5.3

Oct 12th, 2025

This release addresses an issue with responsiveness of the editor in the third step of the wizard.

v2.5.2

Oct 9th, 2025

This release addresses an issue where the AI-powered Automated Mapping feature was not automatically activated in certain scenarios.

v2.5.0

Sep 18th, 2025

importOK now supports AI-powered Automated Mapping to match CSV/Excel headers to system fields automatically, and AI Bulk Transformation to clean or reshape data using plain-language prompts (e.g., splitting names, standardizing dates, normalizing values).

Both features are available today and free for new and existing customers who sign up within the next month, with a 1-month trial included.

v2.4.2

Aug 2nd, 2025

This release improves the performance and reliability of the find-and-replace functionality in the editor. It also addresses an issue where the “Add new record” button was not always working correctly.

v2.4.1

Jul 29th, 2025

This release introduces a fake progress bar when records are imported using onImportReady. This provides a better user experience by giving users a visual indication of the import progress.

v2.4.0

Jul 22nd, 2025

This release introduces several new features and improvements:

Added the allowManualRecords configuration option that enables a button in the third step of the import wizard to add new records manually. This allows users to add new records in addition to their uploaded file.
Extended the sampleFile configuration option to accept File objects in addition to URL strings, allowing developers to dynamically construct the sample file for download.
Implemented the unflatten() method for the ImportRecord class to convert fields with array notation into nested object structures.

v2.3.0

Jul 4th, 2025

This release introduces the Angular component, allowing you to easily integrate importOK into your Angular applications.

v2.2.1

Jul 2nd, 2025

This release updates the limitations for custom transformers, validators, and providers on the Tester plan, by allowing limited functionality for these features instead of blocking them entirely.

v2.2.0

Jun 28th, 2025

This release introduces a new editorMode option that allows you to choose between two editing experiences: advanced and basic. This gives you more control over how users interact with the editor, depending on their needs and familiarity. For more details, see the Props documentation.

v2.1.2

Jun 20th, 2025

This release introduces several improvements to user interaction and visual feedback across the app. Dropdown behavior in typeahead elements has been refined for a smoother experience, error states are now more visually consistent, and keyboard navigation has been improved.

v2.1.1

Jun 16th, 2025

This releases addresses a bug where changes made through the editor could be lost. It also addresses an issue with the errors dropdown not being updated correctly when new type of errors occurred.

v2.1.0

Jun 15th, 2025

This release extends ImportRecord.markAsRejected to accept an optional reason parameter. This allows you to provide a reason for the rejection, which is included in the file with the rejected records. This is particularly useful for providing feedback to users about why their records were rejected. For more details, please refer to the webhooks docs.

v2.0.5

Jun 11th, 2025

This release enhances the user experience of the typeahead component in the third step of the wizard. The component now highlights the matching portion of each option’s label, making it easier to identify relevant results. Additionally, it will always display all available options, even if an invalid value was previously selected.

v2.0.4

Jun 10th, 2025

This release improves the support for Next.js .

v2.0.1

May 28th, 2025

This release addresses an issue when disconnecting the component, before the file was uploaded.

v2.0.0

May 10th, 2025

We're pleased to introduce importOK v2, a major release that brings new capabilities, a more refined user experience, and performance improvements.

v1.8.0

May 6th, 2025

This release exposes LevenshteinMappingStrategy that can be used to extend or partially overwrite the default mapping strategy.

v1.7.2

Apr 9th, 2025

This release addresses an issue where requests to the API were running in the background, even after the component was destroyed.

v1.7.1

Apr 7th, 2025

This release addresses an issue where the dropdown was not displayed correct at the bottom of the editor.

v1.7.0

Mar 19th, 2025

This release exposes a set of metadata from importOK to webhooks like the file size and name, as described in the webhooks documentation.

v1.6.0

Mar 1st, 2025

This release introduces a new type of validators that have access to the full context (all import records), so that it is possible to apply global validations like unique.

v1.5.2

Feb 26th, 2025

This release addresses an issue with data providers, where the label was submitted as the value.

v1.5.1

Feb 3rd, 2025

This release improves the data preview in the second step for Excel files.

v1.5.0

Jan 31st, 2025

This release adds a new transformer called date to convert to a date from Excel format or Unix timestamp into YYYY-MM-DD.

v1.4.4

Jan 27th, 2025

This release addresses an with the build-in validator between ignoring the zero values.

v1.4.3

Jan 20th, 2025

This release addresses an issue with Excel files, where the values were not loading for headers including new lines.

v1.4.2

Jan 15th, 2025

This release fixes an issue where the class editor-feedback-errors was never loaded. It also improves the label to be 1 error instead of 1 errors.

v1.4.1

Jan 10th, 2025

This releases improves the tab navigation in the editor. It also addresses an issue with the onImportProgress where the last update as not always fired.

v1.4.0

Jan 5th, 2025

This release adds a new callback notifying about the progress made in the last step of the wizard. You can find more details in the customization guide.

v1.3.1

Dec 4th, 2024

This release adds a new transformer called date to convert to a date from Excel format or Unix timestamp into YYYY-MM-DD.

v1.3.0

Nov 27th, 2024

This release adds two events to help you monitor the user navigation between steps in the wizard. You can find more details in the customization guide.

v1.2.0

Nov 13th, 2024

This release adds the capability to resize the columns in the spreadsheet editor.

v1.1.2

Nov 10th, 2024

This release addresses an issue with the onImportProgress where the last update as not always fired.

v1.1.1

Nov 1st, 2024

This release addresses a styling issue with Firefox for the second and third step of the wizard.

v1.1.0

Oct 7th, 2024

This release adds a new customization option, to adjust the styling of the import wizard. Please refer to the styling guide to view the available classes and examples.

v1.0.2

Oct 2nd, 2024

This release addresses an issue when filtering by errors.

v1.0.1

Sep 30th, 2024

This release addresses an issue with dropdowns in the second step of the wizard.

v1.0.0

Sep 20th, 2024

This first major version is out 🎉

v0.15.1

Sep 13th, 2024

This release resolves an issue with some translations. It also improves how typeahead works by highlighting the suggested value.

v0.15.0

Sep 1st, 2024

This release brings significant improvements to transformers.

Firstly, validators can now be async functions, allowing you to connect to your API for more advanced transformations.
Additionally, validators can be used with data providers, enabling scenarios like as:countries. Please refer to the documentation for more details, and don’t hesitate to reach out to support.
Furthermore, a few bugs were addressed including updating the number of errors when records are deleted.

v0.14.4

Aug 31st, 2024

This release improves the user experience further in the first and third step of the editor. The most notable change is the capability to navigate and selected using arrow up, down and enter keys in the typeahead component.

v0.14.3

Aug 28th, 2024

This release brings consistency to the wizard height to avoid layout shifting between different steps.

v0.14.2

Aug 24th, 2024

This release fixes a minor bug in the mapping step of the wizard.

v0.14.1

Aug 21st, 2024

This release fixes an issue where the record value was displayed in the editor, instead of the label.

v0.14.0

Aug 20th, 2024

This release brings significant improvements to validators. Firstly, validators can now be async functions, allowing you to connect to your API for more advanced validations. Additionally, validators can be used with data providers, enabling scenarios like in:countries. To facilitate this, data providers have been revised, which includes some backward-incompatible changes. Please refer to the documentation for more details, and don’t hesitate to reach out to support.

Furthermore, a few bugs were addressed including updating the number of errors when records are deleted.

v0.13.3

Aug 14th, 2024

This release extends the editor even further so that all cells are editable. Previously, only cells with errors were editable. It also improves the positioning of the dropdown and tooltip components in the editor.

v0.13.0

Aug 4th, 2024

This release brings internationalization. Spanish, Italian, French and other languages are now available, while it is possible to add your own translations as well.

v0.12.0

Jun 24th, 2024

This release brings a ton of new features. First of all, data preview is now available in the second step of the wizard. We have replaced the native select dropdown with better looking dropdowns. We are also providing the option to overwrite the default mapping strategy. Last but not least, it is now possible to perform async requests to your API and provide suggestions as the users type.

v0.11.0

Jun 13th, 2024

This release adds a new option called uploadedFile which allows you to pass a raw File and hence skipping the upload area. Useful when you offer an upload zone in your application already.

v0.10.8

Jun 8th, 2024

This release improves the support for Webpack 4 and for Excel.

v0.10.7

Jun 8th, 2024

This release improves support for React 16.

v0.10.6

May 14th, 2024

This release improves the registration of new, custom validators and transformers.

v0.10.5

May 6th, 2024

This release improves the support for the React component. It also fixes an error appearing when navigating away from wizard, before uploading any file.

v0.10.4

Apr 29th, 2024

This release introduces the transformers and validators properties to define custom transformers and validators.

v0.10.3

Apr 27th, 2024

This release introduces the description property in fields schema. Useful to provide further context about the field to be mapped.

v0.10.2

Mar 20th, 2024

This release brings several enhancements to the built-in editor. First of all, visual changes were done to indicate that all rows can be selected at once. Secondly, support added to select a range of rows by pressing Shift button - similar to Microsoft Excel. Last but not least, bugs were fixed related to lazy loading and filtering so that the visible section is already populated.

v0.10.1

Mar 15th, 2024

This release addresses the problem where validations were inconsistently logged in the dropdown.

v0.10.0

Mar 10th, 2024

This release focuses on refining the user experience with key features. End users can now indicate whether their file includes a header with column names, which can be used for mapping. If a header is not available, columns are called "A", "B", "C" etc like in Excel.

Additionally, a "Go Back" button has been introduced on every step of the wizard, to allow end users to go back and make changes - without restart the process over!

Word wrap and break issues for editor headers have also been addressed.

Last but not least, sample_file has been renamed to sampleFile to improve consistency.

v0.9.4

Mar 1st, 2024

This release resolves raised issues, primarily addressing the accurate calculation of row height when presenting a limited number of records (less than 10). Additionally, a new validator named number has been introduced, supporting validation for both decimal numbers and integers.

v0.9.3

Feb 27th, 2024

An issue was addressed in this release where the mapping was entirely ignored.

v0.9.0

Feb 22nd, 2024

This release focuses on improving performance. Adding support for large files, and improving the overall user experience by using lazy loading for the editor. Transformations and Validations are also executed asynchronously, to avoid blocking the UI.

The easiest way to import data

Ready for your app

Get importOK

Free trial available