Skip to content

Conversation

@satishashilwar
Copy link

Problem
When uploading multiple images to the product gallery in Magento 2.4.7+, images appear in random order instead of maintaining the user's selection order. This regression was introduced during the migration from jquery/fileUpload to Uppy for handling file uploads.

Root Cause
The migration to Uppy changed file upload behavior from sequential to asynchronous processing. While this improved performance, it broke order preservation because the upload-success handler added images to the gallery immediately upon completion, regardless of their original selection order.

Solution
Enhanced the base image uploader to track file selection order and buffer upload results:

Contribution checklist (*)

  • Pull request has a meaningful description of its purpose
  • All commits are accompanied by meaningful commit messages
  • All new or changed code is covered with unit/integration tests (if applicable)
  • README.md files for modified modules are updated and included in the pull request if any README.md predefined sections require an update
  • All automated tests passed successfully (all builds are green)

When multiple images are selected for upload, maintain the original
selection order instead of displaying them in the random order they
complete uploading.

Problem:
- Migration from jquery/fileUpload to Uppy in 2.4.7 introduced async
  file uploads without preserving selection order
- Images appear in gallery in the order uploads complete, not selection order
- Affects user experience when uploading multiple product images

Solution:
- Track file selection order during onBeforeFileAdded callback
- Buffer upload results and add them to gallery in correct order
- Handle partial failures gracefully while maintaining order
- Reset tracking variables between upload batches

Changes:
- Added filePositions tracking object to map file IDs to selection order
- Added uploadedFiles buffer to store results temporarily
- Modified upload-success handler to wait for all uploads before adding
- Added upload-error handler for proper error handling
- Enhanced complete handler for edge case cleanup

Tests:
- Verified JavaScript syntax is valid
- Handles single and multiple file uploads
- Maintains order even with async upload completion
- Gracefully handles upload errors and partial failures

Fixes: magento#39286
Added JavaScript tests to verify:
- File selection order is preserved during async uploads
- Partial upload failures are handled correctly while maintaining order
- Upload completion logic works with different file completion orders

Tests cover the core functionality of the magento#39286 fix.
@m2-assistant
Copy link

m2-assistant bot commented Dec 15, 2025

Hi @satishashilwar. Thank you for your contribution!
Here are some useful tips on how you can test your changes using Magento test environment.
❗ Automated tests can be triggered manually with an appropriate comment:

  • @magento run all tests - run or re-run all required tests against the PR changes
  • @magento run <test-build(s)> - run or re-run specific test build(s)
    For example: @magento run Unit Tests

<test-build(s)> is a comma-separated list of build names.

Allowed build names are:
  1. Database Compare
  2. Functional Tests CE
  3. Functional Tests EE
  4. Functional Tests B2B
  5. Integration Tests
  6. Magento Health Index
  7. Sample Data Tests CE
  8. Sample Data Tests EE
  9. Sample Data Tests B2B
  10. Static Tests
  11. Unit Tests
  12. WebAPI Tests
  13. Semantic Version Checker

You can find more information about the builds here
ℹ️ Run only required test builds during development. Run all test builds before sending your pull request for review.


For more details, review the Code Contributions documentation.
Join Magento Community Engineering Slack and ask your questions in #github channel.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant