DocumentationTools

ACP2E-4628: Importing customers with uppercase email addresses triggers an undefined array key error when Account Sharing is set to Global

Last update: May 14, 2026

CREATED FOR:

  • Experienced
  • Admin
  • Developer

The ACP2E-4628 patch fixes the issue where importing customers with uppercase email addresses causes an undefined array key error when Account Sharing is set to Global, resulting in import failure. This patch is available when the Quality Patches Tool (QPT) 1.1.78 is installed. The patch ID is ACP2E-4628. Please note that this issue is scheduled to be fixed in Adobe Commerce 2.4.9.

Affected products and versions

The patch is created for Adobe Commerce version:

  • Adobe Commerce (all deployment methods) 2.4.8-p1

Compatible with Adobe Commerce versions:

  • Adobe Commerce (all deployment methods) 2.4.8 - 2.4.8-p4
NOTE
The patch might become applicable to other versions with new Quality Patches Tool releases. To check if the patch is compatible with your Adobe Commerce version, update the magento/quality-patches package to the latest version and check the compatibility on the Quality Patches Tool: Search for patches page. Use the patch ID as a search keyword to locate the patch.

Issue

Customer import fails with an undefined array key error when uppercase email addresses are used with Global Account Sharing enabled.

Steps to reproduce:

  1. Go to Stores > Settings > Configuration > Customers > Customer Configuration > Account Sharing Options.

    1. Set Share Customer Accounts to Global.

  2. Go to System > Export > Customer Main File and export an existing customer.

  3. Go to System > Import > Customer Main File.

    1. Set Import Behavior to Add/Update Complex Data.
    2. Upload the exported file without making any changes.

  4. Click the Check Data button.

Expected results:

The customer import should complete successfully without any errors, even when email addresses contain uppercase characters and Account Sharing is set to Global.

Actual results:

The import fails with the following error:

Warning: Undefined array key "Uppercase.Email@example.com" in app/code/Magento/CustomerImportExport/Model/ResourceModel/Import/Customer/Storage.php on line 117

Apply the patch

To apply individual patches, use the following links depending on your deployment method:

To learn more about Quality Patches Tool, refer to:

recommendation-more-help
commerce-operations-help-tools