GravityImport changelog

2.12.5 Latest 22 Oct 2026 1 improved1 security1 changed

Improved

Improved security when displaying CSV values, file names, and form titles during an import.

Security

This update improves security when importing CSV files.

Changed

Foundation to version 1.38.0.

2.12.4 8 Oct 2026 1 fixed5 changed

Fixed

This release fixes several import issues, including Dynamic Lookup fields that imported nothing and imports that never started.

Changed

Columns mapped to a Dynamic Lookup field set to "Multiple Choice" with multiple selections allowed imported nothing even though the import reported success; cells listing the field's stored values, such as record IDs (3, 1), now select those choices.
Entries imported in the background could have no "Created By" user, and imported notes without their own author had none either (both now belong to the user who started the import).
Imports stayed on "Preparing to import…" and never ran when GravityKit's "Enable Background Processing" setting was off but GravityImport's was on (these imports now run in the browser).
With Gravity Forms 3.0.3 or newer, rows rejected for the form as a whole, such as a row whose only value was in a field hidden by conditional logic, were blamed on an anti-spam or CAPTCHA plugin instead of showing Gravity Forms' reason.
Foundation to version 1.36.0.

2.12.3 1 Oct 2026 1 new1 fixed10 changed

New

Added gk/gravityimport/column/checkbox/delimiter filter to change the separator between choices in a cell mapped to "(Any Choice)" (comma by default).

Fixed

This update fixes Quiz scoring, File Upload, and choice field import issues, along with incorrect messages shown while mapping fields.

Changed

Note: GravityImport now requires Gravity Forms 2.9.4 or newer.
Imported Quiz entries could have the wrong score, percentage, and grade because the form's last question was skipped and the one before it was counted twice.
File Upload field issues:
Files imported into a single-file File Upload field created with Gravity Forms 2.10 or newer did not appear on the entry, its Edit screen, in Views, or in merge tags, even though the files were downloaded
When a row kept a file link formatted as a list (such as ["https://example.com/photo.png"]), files downloaded into other File Upload fields in that row were lost
After a row failed to import, later rows stored single-file File Upload values as a list instead of a single link.
A CSV column mapped to the "(Any Choice)" option of a Checkboxes, Multiple Choice, or Image Choice field left every box unchecked when a cell listed several comma-separated choices (for example, friday,saturday).
The "Email Will Be Rejected" notice on the Map Fields step showed "%s" instead of the email patterns Gravity Forms rejects.
The format dialog for unrecognized dates and times named MM/DD/YYYY or hh:mm AM/PM as the default even when another format was in use, such as YYYY-MM-DD hh:mm:ss for Entry Date.
Foundation to version 1.35.0.

2.12.2 24 Sep 2026 1 fixed5 changed

Fixed

This release fixes issues with importing Consent fields.

Changed

Note: GravityImport now requires WordPress 6.5 or newer.
Issues when importing Consent fields:
The form's consent text could be overwritten, and imported entries linked to the wrong version of the terms
Consent terms containing % or _ were saved as a new version on every import.
Foundation to version 1.33.0.

2.12.1 17 Sep 2026 1 fixed9 changed

Fixed

This release fixes importing into Multiple Choice and Image Choice fields, and into file upload fields on Gravity Forms 3.1.2 or newer.

Changed

Files were not imported into file upload fields on Gravity Forms 3.1.2 or newer, which rejected every row with "The file is not valid."
Multiple Choice and Image Choice fields set to "Select One" could not be mapped as a single column — the mapping step offered only their individual choices, and the column was dropped while the import still reported success.
Existing mappings to an individual choice are now rejected with a message naming the field to map instead, or skipped with a warning when an import profile runs from the command line.
Multiple Choice and Image Choice fields that allow more than one selection stored cell values such as 1, yes, 0 or no as the selected choice instead of treating them as Checkbox columns do.
1, true or yes selects the choice, while 0, false, no or an empty cell leaves it unselected
"(Any Choice)" is available as a mapping target
Rows that don't meet an "Exact Number" or "Range" selection limit are reported as errors.
Row errors showed HTML character codes such as < and & in the import log and the failed records download, including around formatted text in Gravity Forms messages.
Foundation to version 1.32.1.

2.12.0 30 Jul 2026 2 fixed5 changed

Fixed

This release gives clearer reasons when rows fail to import, and fixes file upload imports on Gravity Forms 3.0+, a fatal multi-file upload field error, and compatibility issues with GravityView and WordPress 6.7.
Resolved a "translation loading was triggered too early" notice on WordPress 6.7+.

Changed

Rows rejected by a form-level validation failure now report the actual cause instead of "Failed validation: Unknown" — including when Gravity Forms is blocking submissions while its database upgrade is pending (common on freshly cloned staging sites), or when an anti-spam or CAPTCHA plugin rejects the submission.
Entries imported with an Entry Status column using different capitalization (e.g., Active) could not be opened or edited in GravityView; the standard statuses (active, spam, trash) are now saved in the lowercase form Gravity Forms expects.
Imports with a file upload column failed on Gravity Forms 3.0+ — downloaded files are now given a temporary name matching the uploaded file's extension, which Gravity Forms 3.0+ requires.
A row rejected by a multi-file upload field caused a fatal error on PHP 8; on PHP 7.4 the error named the field but left the reason blank.
Foundation to version 1.27.0.

2.11.3 25 Jun 2026 1 fixed3 changed

Fixed

This release fixes imports to forms that are connected to a Pod through the Pods Gravity Forms add-on.

Changed

Imports to forms mapped to a Pod via the Pods Gravity Forms add-on now import reliably: every row is saved to the Pod, and a row that leaves a required Pods field empty no longer stops the whole import.
A feed that errors while importing a row no longer stops the whole import; the row is recorded as an error and the import continues.
Foundation to version 1.24.2.

2.11.2 4 Jun 2026 1 fixed2 changed

Fixed

This hotfix resolves an issue affecting the Map Fields step when importing large CSV files.

Changed

The Map Fields step could appear blank when importing very large CSV files.
Foundation to version 1.21.0.

2.11.1 28 May 2026 1 new1 fixed2 changed

New

Added gk/gravityimport/source/allowed-wrappers filter to control which PHP stream-wrapper schemes are accepted as import sources.

Fixed

This release fixes imports that failed on certain configurations.

Changed

Imports failed on hosts where uploaded files are not served from the local filesystem (for example, vip:// on WP VIP or s3:// on sites using object storage).
Foundation to version 1.20.0.

2.11.0 21 May 2026 2 new1 improved5 changed

New

This release adds the ability to save and reuse import configurations, run imports via WP-CLI, and disable background processing site-wide.
Added gk/gravityimport/processor/background/enabled filter to programmatically control whether background processing runs for an import, either site-wide or per form. The filter receives the resolved boolean and an optional form ID.

Improved

Support for importing files from the command line via WP-CLI.

Changed

Ability to save field mappings and import options as a downloadable file that can be loaded to restore the same configuration on subsequent imports.
"Enable Background Processing" setting under GravityKit → Settings → GravityImport to turn off background imports site-wide and force synchronous processing.
On the import completion screen, the "Modify Import Configuration" and "Change Field Mapping" buttons are now labeled "Retry N Failed Records" and "Remap & Retry N Failed Records" to make it clearer that the retry action applies only to failed rows.
Faster loading of the form picker on the importer page.
Foundation to version 1.19.0.

2.10.0 23 Apr 2026 1 fixed5 changed

Fixed

This release enables background imports on sites protected by HTTP Basic Authentication, resolves issues that could cause imports to fail on certain hosting environments, and fixes import notifications on Gravity Forms 2.9.31.3 and later.

Changed

Background imports can now run on sites protected by HTTP Basic Authentication, such as password-protected staging and development environments.
Large imports could end with an "Import Incomplete" error when the dataset required multiple execution cycles to finish.
Imports could be incorrectly marked as failed mid-execution on certain hosting environments.
Import notifications were not sent when async notifications were enabled in Gravity Forms 2.9.31.3 or later.
Foundation to version 1.16.0.

2.9.0 12 Mar 2026 2 improved1 fixed9 changed

Improved

Retry only the rows that failed — using the same field mapping or an updated one
Better memory handling when processing imports with many failed records.

Fixed

This update adds background import processing, introduces the ability to retry failed records without re-importing successful ones, improves memory handling during imports, and fixes issues with cancelled import reporting and conditional logic settings.

Changed

Background import processing:
Imports now run in the background — you can close the browser tab and return later
A live progress notice appears across the WordPress admin with a link back to the import page
Pause, resume, and cancel controls are available on the import page.
Failed record recovery:
Download failed rows as a CSV, including a column explaining why each row failed.
Conditional logic settings from a previous import no longer carry over when the option is disabled on the Configure step.
Cancelled imports now correctly report skipped and errored rows in the summary.
Foundation to version 1.12.0.

2.8.1 26 Feb 2026 1 fixed2 changed

Fixed

This hotfix restores the missing "Ignore Field Conditional Logic" toggle in the Configure step.

Changed

"Ignore Field Conditional Logic" toggle not appearing in the Configure step, causing imported field values to be cleared when conditional logic conditions were not met by the CSV data.
Foundation to version 1.11.0.

2.8.0 5 Feb 2026 3 improved1 fixed14 changed

Improved

Better keyboard navigation: use Tab to move between fields, Enter to confirm selections, and Escape to cancel edits.
Improved screen reader support and accessibility throughout the import interface.
Better support for right-to-left (RTL) languages.

Fixed

This update completely redesigns the field mapping experience with a new vertical layout, adds pre-import data validation, includes numerous usability and accessibility improvements, and fixes a fatal error when importing List field data on PHP 8+.

Changed

Redesigned field mapping interface with a vertical layout that's easier to scan and work with, especially for CSVs with many columns.
Pre-import validation warnings that highlight potential data issues like invalid emails, non-numeric values, or unrecognized date/time formats before importing.
Checkboxes to quickly select or deselect which columns to import, with a header checkbox to select or deselect all.
Auto-map button to reset field mappings to auto-detected values, with a confirmation dialog to prevent accidental resets.
Cell-level validation highlighting in the data preview, making it easier to spot exactly which values need attention.
Inline column name editing for renaming CSV column headers before importing.
Validation now checks up to 50 rows of data (previously 10), giving a more accurate picture of potential issues before importing.
Date and time formats are now auto-detected from CSV data instead of requiring manual selection.
Datetime values with milliseconds (e.g., 2024-12-01 00:43:21.000) are now parsed correctly.
Smarter field matching means fewer manual adjustments when mapping CSV columns to form fields.
Entry Notes now requires exact column name matches, preventing accidental mapping of unrelated columns.
The "Ignore Field Conditional Logic" option now only appears when the form actually has conditional logic.
Fatal error when importing List field data on PHP 8+.
Foundation to version 1.9.0.

2.7.0 11 Sep 2025 1 new1 improved1 fixed4 changed

New

New GravityKit global settings for logging configuration (level, type, cleanup schedule, retention)

Improved

Performance improvements and bug fixes.

Fixed

This update improves GravityView's Approval Status field imports and fixes PHP-related issues.

Changed

Importing GravityView's Approval Status values now works with both text labels ("Approved", "Disapproved", "Unapproved") and their numeric equivalents (1, 2, 3).
PHP 8.1+ warnings and intl extension conflict on some hosts.
Foundation to version 1.3.1:
A unified way to display admin notices across all GravityKit products

2.6.0 17 Jul 2025 3 improved3 changed

Improved

This update improves import reliability by better managing server resources during large imports.
Import performance and reliability have been enhanced with smarter memory and timeout management.
Refactored server resource management into a dedicated Server helper class.

Changed

The import process now better detects available server resources and adjusts accordingly.
Large CSV imports are now more stable and less likely to fail due to resource constraints.
Foundation to version 1.2.25.

2.5.1 21 Nov 2024 1 fixed2 changed

Fixed

This hotfix update addresses a non-critical PHP notice in WordPress 6.7 and newer.

Changed

PHP notice in WordPress 6.7 caused by initializing product translations too early.
Foundation to version 1.2.21.

2.5.0 16 Aug 2024 2 new1 improved

New

This release updates internal components and adds a filter to assist in troubleshooting and preventing network errors.
Added gk/gravityimport/rest/request-validation-skip-params filter to allow customization of which REST request parameters are excluded from validation when processing batch requests.

Improved

Foundation was updated to version 1.2.17.

2.4.10 25 Jan 2024 1 new2 improved1 fixed2 changed

New

Added a gk/gravityimport/ui/form-data filter to modify the form data object for use in the UI.

Improved

Foundation was updated to version 1.2.7.
Improved the setting and retrieval of transients when using object cache plugins.

Fixed

Fixed a JavaScript warning that appeared during the deactivation of license keys.

Changed

This release introduces a new filter for developers to modify UI data, resolves a PHP 8.1+ deprecation notice, and updates the Foundation framework, enhancing support for sites that use object caching plugins.
A deprecation notice in PHP 8.1+ caused by passing null as a parameter to built-in string functions.

2.4.9 7 Sep 2023 2 improved1 fixed

Improved

Support for RTL languages
Foundation to version 1.2.2

Fixed

Auto-mapping of the User IP field not working

2.4.8 12 Jul 2023 1 improved

Improved

Foundation to version 1.1.1

2.4.7 3 May 2023 1 improved1 fixed

Improved

Foundation to version 1.0.12

Fixed

Incompatibility with some plugins/themes that use Laravel components

2.4.6 9 Mar 2023 1 new1 improved1 changed

New

Option to ignore field conditional logic during import

Improved

Foundation to version 1.0.10

Changed

Note: GravityImport now requires PHP 7.2 or newer

2.4.5 5 Jan 2023 1 improved

Improved

Foundation to version 1.0.8

2.4.4 21 Dec 2022 2 fixed

Fixed

PHP 8.1 notices
Fatal error on some hosts due to a conflict with one of the plugin dependencies (psr/log)

2.4.3 1 Dec 2022 1 fixed

Fixed

It was not possible to remove an expired license key

2.4.2 29 Nov 2022 1 fixed

Fixed

"Undefined index" PHP notice

2.4.1 14 Nov 2022 3 fixed

Fixed

Fatal error when loading plugin translations
Slow loading times on some hosts
Plugin failing to install on some hosts

2.4.0.3 31 Oct 2022 1 fixed

Fixed

Plugin was not appearing in the "Add-Ons" section of the Gravity Forms System Status page

2.4.0.2 20 Oct 2022 1 fixed

Fixed

Potential error when the plugin tries to log an unsuccessful operation

2.4.0.1 19 Oct 2022 1 fixed

Fixed

Error when trying to activate license keys

2.4 19 Oct 2022 1 new1 removed8 changed

New

New WordPress admin menu where you can now centrally manage all your GravityKit product licenses and settings (learn more about the new GravityKit menu)

Removed

Removed actions:

Changed

Go to the WordPress sidebar and check out the GravityKit menu!
We have automatically migrated your existing GravityImport license, which was previously entered in the Gravity Forms settings page
Request support using the "Grant Support Access" menu item
Developer Updates:
Gravityview/import/settings/before
Gravityview/import/settings/after
Gravityview-import/before-settings
Gravityview-import/after-settings

2.3.0.2 27 Jul 2022 1 fixed

Fixed

GravityImport license section was missing from the Gravity Forms Settings screen

2.3.0.1 18 Jul 2022 1 fixed

Fixed

The option to import entries was missing from the Gravity Forms Entries and WordPress Import screens

2.3 7 Jul 2022 1 fixed3 changed

Fixed

It was not possible to access form field properties in Gravity Forms 2.6+ if the form was created during import

Changed

GravityView (the company) is now GravityKit and this plugin is now called GravityImport!
Developer Updates:
IMPORTANT: GVImport_Entries namespace was renamed to GravityKitGravityImport and future plugin versions will see similar name changes to the REST namespace, constants, and hooks

2.2.6 27 Jan 2022 1 improved1 fixed1 changed

Improved

Warning message that's displayed when CSV data is mapped to an Entry ID field now clearly states that all existing entry data will be deleted

Fixed

Import fails to start when pt_PT_ao90 (variant of pt_PT) locale is used

Changed

Tested with WordPress 5.9

2.2.5 1 Oct 2021 1 fixed

Fixed

Import would fail if GravityExport is installed

2.2.4 31 Aug 2021 2 fixed

Fixed

New form creation capabilities were being checked when importing into an existing form
If specified, hours and minutes were not being saved when updating "Entry Date", "Entry Updated Date" and "Payment Date" entry properties

2.2.3 20 Jul 2021 1 fixed

Fixed

Zeros could not be imported into a number field

2.2.2 6 May 2021 1 improved3 fixed

Improved

Modified code to improve future support for Image Hopper

Fixed

Compatibility with Gravity Forms Zero Spam plugin
Import may silently fail when the database contains a large number of entries (thanks, Alexander St. John!)
PHP warnings when running Gravity Forms Entries in Excel

2026 14 versions

2025 2 versions

2024 3 versions

2023 5 versions

2022 12 versions

2021 4 versions

Uptime status page