Order File Attachments for Magento 2
Let Magento 2 customers upload and attach files to specific order items during checkout. Includes admin grid management, thumbnail previews and downloads.
- Licence
- Open source, free to install
- Compatibility
- Magento 2.4.4 to 2.4.9, Hyvä and Luma
- Installed for you
- from $22
- Category
- Checkout & cart
Install
composer require mage2kishan/module-order-attachmentsThen bin/magento setup:upgrade. On Packagist as mage2kishan/module-order-attachments.
Questions about Order File Attachments
How is this different from Magento's native "file" custom option?
Native file custom options are tied to the cart quote item and don't persist cleanly as a first-class order record. Panth Order Attachments creates dedicated panth_quote_attachment and panth_order_attachment tables, linked to the sales order item, ensuring files remain accessible for the full order lifetime, including reorders, invoices, and RMAs.
Can customers upload multiple files per product?
Yes. Set Max Files Per Item in configuration (default 5). Each enabled product in the cart accepts up to that many files.
Does it support Hyvä?
Yes. The frontend widget has both Luma (PHTML + vanilla JS) and Hyvä (Alpine.js + Tailwind) implementations, auto-selected via Panth\Core\Helper\Theme.
What file types are supported?
Any extension you configure. Defaults: jpg, jpeg, png, gif, pdf, doc, docx, zip. You can add ai, psd, eps, svg, tif, xlsx, etc.
Where are files stored?
In var/order_attachments/ with SHA-256 hashed filenames. The directory is not publicly browsable; files are served only through authenticated controllers.
Can guests use Order Attachments?
Yes. Both guest and registered customer checkouts are supported.
Can the admin delete or replace an attachment after the order is placed?
Yes. Admins can soft-delete or download any attachment from the grid and order view tab.
Does it work with Adobe Commerce Cloud?
Yes. Files are stored in the writable var/ directory which is persisted across deploys on ACC.
Does it support multi-store?
Yes. Configuration respects default → website → store view scope. Attachments are stored per order regardless of store view.
Is a REST API available?
REST endpoints for listing and downloading attachment metadata are included. GraphQL support is on the roadmap.
Need Order File Attachments set up or extended?
Installation, configuration and custom work on any of the modules, quoted in writing within 24 hours.