Skip to main content

Release Notes v4

info

As of version 4.x, all frameworks now use the new scoped packages: @ingestro/importer-react, @ingestro/importer-angular, @ingestro/importer-vue, and @ingestro/importer-vanilla-js. These packages replace the older @getnuvo/** packages used in versions 3.x.

While you can continue using the previous versions, we recommend migrating to the new @ingestro/importer-* packages to benefit from the latest features, performance improvements, and ongoing support.

10.09.2026​

4.9.8​

Changed​

  • Moved PDF parsing back to our servers for cloud deployments, reversing the browser-only parsing announced in 4.9.0 and improving table extraction on scanned PDFs. Self-hosted deployments still parse PDFs in the browser.

4.9.7​

Superseded by 4.9.8 and no longer available on npm. Please install 4.9.8 or later.

4.9.6​

Superseded by 4.9.8 and no longer available on npm. Please install 4.9.8 or later.

04.09.2026​

4.9.5​

Fixed​

  • Fixed an issue where date-formatted Excel cells that appeared blank were imported as 31.12.1899 instead of empty.

01.09.2026​

4.9.4​

Fixed​

  • Fixed an issue in the Review Entries step where cells kept their red error styling after a cleaning function's error was cleared by an edit elsewhere in the same row.

28.08.2026​

4.9.3​

Added​

  • Added the Input format control to the Match Columns step, which shows the date format the importer uses to read each mapped date column and lets users change it.

Fixed​

  • Fixed an issue where Excel files using a regional short date format had the day and month swapped after upload, so a cell shown as 03.06.26 in Excel was imported as 6/3/26.
  • Fixed an issue where dates with a two-digit year, such as 18.04.26, were read as the year 26 and imported as 0026-04-18.

17.08.2026​

4.9.2​

Added​

  • Added the useDataImporter hook, a hook-based alternative to <DataImporter> for custom upload triggers. This hook was announced for 4.8.0 in error and was not available until this release.

14.08.2026​

4.9.1​

Added​

  • Added internal import logging options for self-hosted deployments.

4.9.0​

Added​

  • Added a modal for XML files, which lets users shape a hierarchical file into one or more sheets by choosing what each row represents and how the related details are included.
  • Added a Remove Rows button to the review step, which removes duplicate or empty rows across all visible columns or a selected subset, with options to ignore case and ignore blanks.
  • Added helper functions to AI Prompts, which let users remove rows by describing what to remove in a prompt.
  • Added the sheetVisibility setting, which controls whether hidden and very hidden sheets of an Excel file can be imported.

Improved​

  • Improved PDF parsing to run entirely in the browser for all deployments, so PDFs are no longer processed on our servers.
  • Improved the Match Columns step so the required asterisk stays visible after a column is matched when mappingViewMode is set to "targetColumns".
  • Improved the Cleaning Assistant by removing the cooldown between refreshes, so new suggestions can be requested at any time.

Fixed​

  • Fixed an issue where the "Clean data" button label wrapped to two lines at narrower viewport widths.
  • Fixed an issue where the header row was not auto-detected when an import started at the sheet selection step through ImporterSession.
  • Fixed an issue where the review step toolbar shifted down when a row checkbox was selected.
  • Fixed an issue where opening a dropdown in the Match Columns step scrolled the page upward, pushing the open dropdown out of view.
  • Fixed two webpack "Critical dependency" warnings emitted when bundling any @ingestro/importer-* package.

31.07.2026​

4.8.5​

Fixed​

  • Fixed an issue where text columns expanded values shaped like scientific notation (e.g. 12150390E012) into a long number, discarding the original text.
  • Fixed an issue where numeric columns did not parse scientific notation written with an uppercase E (e.g. 1.23E-4), even though the lowercase e form parsed correctly.

27.07.2026​

4.8.4​

Fixed​

  • Fixed an issue where mappingStep and onEntryInit received all TDM columns instead of only mapped columns when onlyMappedColumns was enabled, causing custom error highlights to render on the wrong column on the first Review Entries render.

21.07.2026​

4.8.3​

Fixed​

  • Fixed an issue where the Header Selection step preselected a merged banner row instead of the actual header row in XLSX files containing merged cells.

17.07.2026​

4.8.2​

Fixed​

  • Fixed an issue in the Review Entries step where a dropdown cell's info background did not repaint immediately after selecting an option, only appearing after pressing Enter or clicking another cell.
  • Fixed an issue where values that looked like numeric dates were silently reordered to DD/MM/YYYY during file parsing.

14.07.2026​

4.8.1​

Fixed​

  • Fixed an issue where errors added with stepHandler.reviewStep().updateData() did not appear in the Review Step when the handler also called block().

10.07.2026​

4.8.0​

Added​

  • Added the allowColumnNameEdits setting, which adds an "Edit" option to every column's options menu, letting users rename any column.
  • Added the sheetMappingConfiguration setting, which lets the Join Sheets and Append Columns modals use our AI mapping engine to suggest and pre-fill matching columns between sheets.
  • Added the inputFormat column property, which lets you declare a fixed date input format so ambiguous dates parse deterministically instead of relying on auto-detection.
  • Added a compare validation rule, which enforces numeric bounds on a cell using an operator and value.
  • Added onUploadSuccess and onUploadError callbacks, which let you react to file upload outcomes, for example to send analytics events.
  • Added "Warning rows" and "Info rows" tabs to the Review Entries toolbar, letting users filter the grid to rows containing warning-level or info-level cells, alongside the existing "All rows" and "Error rows" tabs.
  • Correction: the useDataImporter hook was listed here in error. It was not included in 4.8.0 and became available in 4.9.2.

Improved​

  • Redesigned the header selection theme, adding style keys for the toolbar, metadata selection, add-column popover, and merge/transpose controls (link).
  • Reduced per-sheet memory usage and removed the five-sheet limit on sheet selection.
  • Improved PDF parsing to run entirely in the browser for self-host customers.
  • Replaced the deprecated numbro dependency with the native Intl.NumberFormat API, reducing bundle size with no change in number formatting behavior.

Fixed​

  • Fixed an issue where row counts (in the review step error tab, action footer, "Ready to submit?" modal, and success screen) were always formatted using German number formatting regardless of the configured language.
  • Fixed an issue where selecting "None" from the filter condition dropdown in the review step caused the Apply button to spin indefinitely.

30.06.2026​

4.7.1​

Added​

  • Added proceed() and stay() to headerStep, mappingStep, and reviewStep in the step handler, enabling custom gate logic and modal flows that control whether the importer advances to the next step.
  • Added the collapseMatchedColumns setting, which collapses all matched rows in the Match Columns step on render so users only expand the rows they need to review.
  • Added the excludeFromAutoMatching column property, which excludes the column from auto-matching so it appears unmapped at the start of the Match Columns step, requiring a deliberate manual selection.
  • Added the disableColumnRemapping setting, which disables selection of already-matched columns to prevent users from accidentally overwriting an established mapping.
  • Added hasMatchIconUrl, notMatchIconUrl, and notMatchErrorIconUrl to style.columnMatch.requiredColumns, allowing custom images to replace the default icons for each required column footer state.
  • Added Angular 22.x support (supported versions).
  • Published TypeScript types for the unmappedValuesBanner style key, which was introduced in v4.6.0 as part of preserveUnmappedOptions. This key replaces notMatchingValue, which was removed in v4.6.0.

Fixed​

  • Fixed an issue where XLSX cells containing large integers or thousands-formatted numbers were parsed incorrectly in the Header Selection and Review steps.
  • Fixed an issue where XLSX values smaller than 1e-6 (e.g. 6.31e-7) were displayed and imported incorrectly due to the scientific notation exponent being dropped during number parsing.
  • Fixed an issue where the AI Prompts feature occasionally wrapped generated formulas in backtick characters, causing the formula to fail evaluation and write broken values to cells.
  • Fixed an issue where the row selection toolbar (Duplicate, Delete, and selected count) did not appear when the host application used React 19 with <StrictMode>.

4.7.0​

Superseded by 4.7.1 and no longer available on npm. Please install 4.7.1 or later.

22.06.2026​

4.6.1​

Added​

  • Added support for Apple Numbers (.numbers) files. .numbers files are always accepted and parsed regardless of the inputTypes configuration.

Fixed​

  • Fixed an issue where columnType: "date" columns using the MMM month token with a hyphen separator (e.g. DD-MMM-YYYY, MMM-DD-YYYY) incorrectly flagged correctly formatted values as invalid in the review step.
  • Fixed an issue where merged header cells in Excel files caused the second merged column to be treated as empty, discarding its data during import.

11.06.2026​

4.6.0​

Added​

  • Added the onStepChange callback, which fires whenever the importer navigates to a new step and provides a step identifier for URL-based funnel tracking and analytics.
  • Added the allowedCustomColumnTypes setting, which restricts which column types users can select when creating a custom column with allowCustomColumns: true.
  • Added the preserveUnmappedOptions column property, which carries unmapped source values forward to the review step instead of discarding them, so users can see and correct the original value inline. The associated style key for this banner was introduced as unmappedValuesBanner, replacing the previous notMatchingValue key.
  • Added support for ODS (OpenDocument Spreadsheet) files as an inputTypes option.

27.05.2026​

4.5.1​

info

The Vue, Angular, and vanilla JavaScript packages advanced to 4.5.2 to include the TypeScript type fix below.

Fixed​

  • Fixed a compatibility issue that caused build failures in webpack environments.
  • Fixed missing TypeScript type definitions for allowedCustomOptionTypes in the vanilla JavaScript package.

26.05.2026​

4.5.0​

Added​

  • Added find & replace support for empty values and category column fields in the review step.
  • Added allowedCustomOptionTypes property to the target data model, which allows restricting which option types (string, int, float) users can select when creating custom dropdown options on category columns with allowCustomOptions: true.

Improved​

  • Improved the loading time of the review step when using manual entry.

Changed​

  • Upgraded nuvo-exceljs to resolve a lodash.isequal deprecation warning.

Fixed​

  • Fixed an issue where the mapping step was not skipped when skipConfiguration.mapping had automaticMapping: true with applyColumnMapping: 'none' and applyOptionMapping: 'none' explicitly set.
  • Fixed an issue where the skip configuration info box persisted after the user navigated back to a skipped step and did not update when only one of two skipped steps had been visited.
  • Fixed an issue where filtering rows, editing a cell, clearing the filter, and then undoing caused the last row to disappear and row numbers to become misaligned.
  • Fixed an issue where selecting "Is error", "Is warning", or "Is info" from the filter condition dropdown in the review step threw a console error and did not apply the filter.
  • Fixed an issue where the undo button was incorrectly enabled on review step entry when the target data model contained isMultiSelect columns, and clicking undo then redo added a phantom empty row.
  • Fixed an issue where the "Show more" button for required columns in the mapping step footer did not appear on initial load when the list overflowed past one line.

13.05.2026​

4.4.0​

Added​

  • Added data-testid attributes to all interactive UI elements across the importer to enable automated testing, analytics tagging, and third-party tool integration.

Changed​

  • Removed unused translation keys from the default locale file and all example locale files to accurately reflect the customizable surface of the importer.

Fixed​

06.05.2026​

4.3.0​

Added​

  • Added skipConfiguration setting, which gives developers granular control over automatically completing and skipping the header selection and mapping steps, with support for saved mapping scenarios, Ingestro's smart auto-matching, and configurable stepper visibility and info boxes.
  • Added tdm.updateColumn() method to stepHandler.mappingStep(), which allows partially modifying existing target data model columns at runtime by shallow-merging changes onto the current column definition (link).

Improved​

  • Improved tdm.addColumn() in stepHandler.mappingStep() to accept an optional { index } parameter for controlling the insertion position of new columns (link).

Deprecated​

  • automaticHeaderDetection and automaticMapping have been deprecated in favor of skipConfiguration. Both settings continue to work when skipConfiguration is not defined.

Fixed​

  • Fixed an issue where browser memory grew when using ImporterSession to upload multiple batches of data, which could cause the browser to crash.
  • Fixed an issue where dropdown options with an empty string value ("") were displayed as unselected in the Match Columns step and output as null instead of "" in stepHandler.mappingStep(), stepHandler.reviewStep(), and onResults.
  • Fixed an issue where column matching dropdowns and category cell dropdowns did not open on non-first <DataImporter> instances when embedding multiple importers with modal: false.

20.04.2026​

4.2.4​

Changed​

  • Upgraded axios to 1.15.0 to address a security advisory in the previous version.

Fixed​

  • Fixed an issue where AI prompts were returning an empty result.
  • Fixed an issue where rows would disappear after clicking "Complete Import" when stepHandler.reviewStep().updateData() was used.

4.2.3​

Superseded by 4.2.4 and no longer available on npm. Please install 4.2.4 or later.

4.2.2​

Superseded by 4.2.4 and no longer available on npm. Please install 4.2.4 or later.

4.2.1​

Fixed​

  • Fixed an issue regarding stepHandler.reviewStep() that was leading to the addition of a dummy header row when using the updateData() function.

09.04.2026​

4.2.0​

Added​

  • Added mergeHeaders setting, which enables users to select and merge multiple header rows into a single combined header row using a configurable separator.
  • Added metadataSelection setting, which enables users to add metadata cells or fixed-value columns during the header selection step.
  • Added columnResize setting, which enables users to dynamically resize column widths by dragging column borders in the table.
  • Added columnWidth property to the target data model, which allows defining a custom column width in pixels.
  • Added transposed, headerRowIndexes, and addedColumns properties to each sheet object in stepHandler.headerStep(), providing visibility into transpose state, selected header rows, and columns added by addColumns or metadata during header selection (link).

Improved​

  • Improved header selection tab design with reduced sizing and truncated sheet and file names, as well as allowing continuing to the next step without reviewing all selected sheets.
  • Improved the styling and expansion behavior of cells with extended text content in the review step to prevent the text box from overflowing past the scrollbar.
  • Improved the alignment of column headers with table values in the review step.
  • Improved font loading by self-hosting fonts instead of loading them from Google Fonts CDN, eliminating external requests to Google servers.

Fixed​

  • Fixed an issue regarding partial mapping failure handling: when the column mapping succeeds but option mapping fails, column mappings are now displayed. Previously, all mappings were blank if any mapping call failed.
  • Fixed an issue where filtering rows and then deleting all selected rows in the review step resulted in incorrect remaining rows and stale filter options.
  • Fixed an issue with cells of date/time columns where if the content was actively removed in the review step, data was output as an empty string (""), instead of null, inside stepHandler.reviewStep().
  • Fixed an issue where native validation error messages in the review step were duplicated each time after clicking "Complete Import" and then "Fix Errors" when updateData was used in stepHandler.reviewStep().
  • Fixed an issue where a console.log statement was unintentionally included in the production build.

13.03.2026​

4.1.0​

Added​

  • Added PSV support to the importer. This feature can be activated by adding "psv" to the inputTypes array (link).
  • Added support for rendering HTML tags in popovers for info, warning, and error messages added via cleaning or stepHandler functions, allowing for rich text formatting and interactive elements like links, lists, etc.

Improved​

  • Improved mapping speed for the exact and fuzzy layer when processingMode is set to "node".
  • Improved the Excel template functionality to take column types into consideration.
  • Improved automaticMapping to allow skipping the mapping step when ImporterSession.upload().step is set to mapping and its a reoccurring input structure.

Fixed​

  • Fixed an issue where printer settings of an uploaded XLSX file led to a broken "Export as Excel" functionality.
  • Fixed an issue where programmatically generated XLSX files could not be parsed.

02.03.2026​

4.0.5​

Fixed​

  • Added a sans-serif fallback font in case the primary font fails to load.
  • Fixed an issue where the execution of AI prompts was blocked by a strict CSP.
  • Fixed a UI bug where the bottom border of the header row in the header selection and review tables was missing.
  • Fixed a UI bug where the content and row numbers in the review table were misaligned.
  • Fixed a UI bug where the title and description in the mapping step were misaligned.

20.02.2026​

4.0.4​

Fixed​

  • Fixed an CORS issue that the cleaning assistant faced for self-host customers.
  • Fixed a bug inside the sheet selection, which led to a crash when continuing without selecting any sheet.

18.02.2026​

4.0.3​

Changed​

  • Replaced the monaco editor dependency to reduce the bundle size (Angular: 11.8MB → 7.71MB, Vanilla JS: 11.8MB → 7.69MB, Vue: 11.8MB → 7.68MB).

Fixed​

  • Fixed a performance issue when using target data models with a large amount of dropdown options that use conditional rendering.
  • Fixed an issue where the date detection and conversion was not applied to dates separated by space or dot.
  • Fixed an issue where the mapping step froze.

10.02.2026​

4.0.2​

Fixed​

  • Fixed an UI issue where the spacing between the value and the left border of input fields was larger for category columns than for other column types.
  • Fixed an issue where the mapping step overflowed the viewport, causing the footer buttons (“Back” and “Continue”) to be off-screen in the second import flow when performing multiple imports consecutively.

04.02.2026​

4.0.1​

Improved​

  • Reduced bundle size by nearly 50% (React SDK: 5.1MB → 2.4MB, Adapters: 12.4MB → 11.8MB).
  • Updated all dependencies to the latest version.

Changed​

  • Renamed component from <NuvoImporter> to <DataImporter> / nuvo-importer to data-importer.
  • Replaced TXT workers with native JS workers for improved performance and compatibility.
    • For Angular projects, you can enable JS workers in development by adding the following configuration to angular.json under projects.architect.assets: 
      {
        "glob": "workers/**/*.js",
        "input": "node_modules/@ingestro/importer-angular",
        "output": "/"
      }
  • Mapping module errors now fail silently and no longer block the user from completing the import process.

Fixed​

  • Fixed an issue where dropdown fields were misaligned when mappingViewMode: "targetColumns" in the mapping step.
  • Fixed an issue where a forwardRef warning was constantly displayed in the console.
  • Fixed an issue where bulk copy and paste was not working for multi-select fields.
  • Fixed an issue where cells of int/float columns where the content was actively removed in the review step were treated as empty string instead of null.
  • Fixed an issue where percentage fields were not displaying the correct numerical value.
  • Fixed an issue where, when modal: false, the mapping step overflowed the viewport, causing the footer ("Back" and "Continue" buttons) to be off screen and forcing the user to scroll down to access the buttons.