
Product Documents for Magento 2 — Datasheets, Manuals & CAD Downloads
Add downloadable files — datasheets, manuals, certificates, brochures and CAD — to your Magento 2 products. Build a document library, attach files (or external links) to any products, restrict them by store view and customer group, track downloads, and serve them on Luma or headless over Grap…
Put datasheets, manuals and CAD files on your Magento 2 product pages
Technical and B2B buyers want the spec sheet, the manual, the compliance certificate and the CAD file before they buy — and Magento has no native way to attach them. Product Documents gives every product a proper downloads section: build a library of files, attach them to any products, and they appear on the product page for customers to download. One document can sit on many products, and one product can carry as many documents as it needs.
What you'll use it for
- Sell to technical buyers — put the datasheet, user manual and compliance certificate right on the product page so the answer to "do you have the spec?" is always yes.
- Share CAD files — attach DWG, STEP or IGES files for engineering and manufacturing parts.
- Gate trade documents — restrict price lists or trade datasheets to your B2B customer group, hidden from retail shoppers.
- Localise manuals — show the right document per store view for an international catalogue.
- See what matters — track download counts to learn which documents customers actually use.
How it works
Document types & file formats
Each document is tagged with a type, so the storefront can group and label them:
Uploads are restricted to a safe allow-list of document and CAD formats:
Built for headless
A productDocuments GraphQL query returns a product's documents — title, description, type, file URL (or external URL), file type, size, sort order and download count — already filtered to the current store and customer group. A trackDocumentDownload mutation records a download from a headless storefront, so your Astro or PWA front end gets the same downloads experience and the same tracking as Luma.
Specifications
| Magento | Open Source 2.4.9 and later 2.4.x |
|---|---|
| PHP | 8.4 and 8.5 (verified) |
| What it does | Attach downloadable documents to products from a reusable library |
| Source | Uploaded file or external URL |
| Document types | Spec sheet, user guide, certificate, technical datasheet, brochure |
| File formats | PDF, Word, Excel, PowerPoint, and CAD (DWG, STEP, IGES) |
| Visibility | Per store view and per customer group; active flag; sort order |
| Headless | productDocuments query + trackDocumentDownload mutation |
| Tracking | Per-document download counter |
| Access control | Manage, Delete and Config permissions |
| Dependencies | None — no third-party libraries |
| Delivery & licence | Composer install, per-domain licence key, updates via Composer |
Works with
Part of the AgenticEcom suite for Catalog & Products:
Included in the Growth and Enterprise bundles.
Frequently asked questions
How do I add a PDF or downloadable file to a Magento 2 product?
Create the document in the library (upload the file or paste an external URL, give it a title and type), then attach it to the products it belongs to. It appears in the product's downloads section for customers.
Can one document go on many products?
Yes. Documents and products are a many-to-many relationship — one datasheet can be attached to a whole range, and a product can carry as many documents as it needs, in your chosen order.
Can I restrict documents to certain customers or stores?
Yes. Each document can be limited to specific store views and specific customer groups — so trade-only datasheets or price lists are hidden from retail shoppers, and region-specific manuals show only where they apply.
What file types can I upload?
PDF, Word (DOC/DOCX), Excel (XLS/XLSX), PowerPoint (PPT/PPTX) and CAD formats (DWG, STP/STEP, IGS/IGES). You can also link to a file you host elsewhere instead of uploading.
Does it work on a headless storefront?
Yes. A productDocuments GraphQL query returns each product's documents (filtered to the current store and customer group), and a trackDocumentDownload mutation records downloads — so a headless front end gets the same experience as Luma.
Can I see how often a document is downloaded?
Yes. Each document keeps a download counter that increments on every download, on Luma or over GraphQL.
Which Magento and PHP versions are supported?
Magento Open Source 2.4.9 and later 2.4.x, verified on PHP 8.4 and 8.5, with no third-party dependencies.

