Table of Contents
Magento 2 Product Attachment User Guide
Related overview
For a shopper-friendly overview of features and setup, see the Magento 2 Product Attachment User Guide - Manuals & Specs on the storefront. This wiki page remains the full technical documentation.
Extension context
This is a Toweringmedia Magento 2 extension guide for the current admin extension catalog.
Product page
- Magento 2 Product Attachment (SKU
tm-product attachment)
Overview
This extension attaches downloadable files — manuals, spec sheets, safety data sheets, warranty documents — to Magento 2 products and categories. Attachments appear in a product page tab, can be reused across products via category assignment, and can optionally be included with customer orders. A download report shows which files customers are actually retrieving.
What this extension does
- Attach files to products and display them in a PDP tab.
- Assign attachments at category level and roll them down to products in that category.
- Group attachments and assign custom file-type icons.
- Optionally include attachments with customer orders.
- Bulk import attachments.
- Download reporting.
Requirements
- Magento 2.4.x (Open Source or Adobe Commerce).
- PHP: ^8.1 || ^8.2 || ^8.3 (as declared by the published package).
- A current Toweringmedia license and Composer credentials for
https://composer.toweringmedia.com/. - Composer resolves
toweringmedia/module-baseautomatically.
Installation
Install and validate in a staging environment before production rollout.
cd /path/to/magento composer require toweringmedia/module-product-attachments bin/magento module:enable Toweringmedia_ProductAttachments bin/magento setup:upgrade bin/magento setup:di:compile bin/magento setup:static-content:deploy -f bin/magento cache:flush
Currently published versions at the time of writing:
toweringmedia/module-product-attachments— 0.1.0
Toweringmedia packages are served from the licensed Composer repository https://composer.toweringmedia.com/. If Composer reports that the package could not be found, your credentials are missing or the license does not cover this package yet. Retrieve your keys from My Account on toweringmedia.com, or contact support@toweringmedia.com.
General installation notes that apply to every Toweringmedia extension are in the installation guide.
Package naming note
The storefront product is named Product Attachment (singular) but the Composer package is toweringmedia/module-product-attachments (plural). The install command above uses the real package name.
Configuration
- Stores > Configuration > Towering Media > Product Attachments (config section
toweringmedia_product_attachments). - Groups:
general(enable, roll category files down to products, show “include in order” on PDP, URL type) andproduct_tab(PDP tab behaviour). - Admin screens: Catalog > Product Attachments, Attachment Icons, Attachment Groups, Import Attachments; Reports > Attachment Downloads.
Basic usage and what to expect
- Upload files under Catalog > Product Attachments and assign them to products or categories.
- Open a product on the storefront and confirm the attachments tab renders with working download links.
- Use Reports > Attachment Downloads to see which documents customers retrieve.
Notes and limitations
- This package is published at a pre-1.0 version.
Validation checklist
bin/magento module:statusshows the module(s) as enabled.- Extension configuration saves without errors in Admin.
- The admin screens listed above are reachable and load without error.
- Expected storefront/admin behavior is present after a cache flush.
- No critical PHP/JS errors appear in
var/log/during the primary test flow.
Troubleshooting
- Composer cannot find the package: confirm the
https://composer.toweringmedia.com/repository and your credentials are present inauth.json, and that your license covers this package. - Feature not visible: verify module status, flush cache, and redeploy static content.
- Admin setting not applying: clear cache and confirm the config scope (default / website / store view).
- Unexpected behavior: retest with only the required related modules enabled.
