3 min readNov 1, 2026by jakub

Product Attachments

Put the datasheet, the manual and the certificate where shoppers make up their mind — on the product page — and keep every document one click away in the customer's account after they buy.

Latest version: 1.3.0 — changelog

The Attachments tab on a Luma product page, listing a datasheet link without a size and a PDF user manual of 0.26 MB

Who it's for

  • Stores whose products come with paperwork. Manuals, datasheets, safety sheets and certificates upload straight onto the product, or link to wherever you already host them.
  • Stores whose customers come back for the manual. Buyers find every document for the products they paid for under My Attachments in their account.
  • Stores that sell in more than one language. Each store view shows only the manuals meant for it, and each attachment can carry its own title in any store view while the others keep the default title.
  • Luma and Hyvä storefronts. A dedicated Hyvä package renders the product section and the account page in the Hyvä theme's own style; Luma gets a product-page tab.

Why it matters

  • Fewer pre-sales questions. Specs and sizing documents answer the question on the page instead of in your inbox.
  • More confident buyers. Documentation a shopper can read before checkout removes a reason to hesitate.
  • Fewer "please resend the manual" tickets. After the sale, customers serve themselves from their account.
  • Documents you can host safely. Uploads are limited to the file types you allow, a file is sent with the type its extension names, and only PDFs, plain text and images ever open in the browser. Everything else downloads.
  • Links you can share without worry. Download links carry an encrypted id, and they stop working as soon as the product is disabled or taken off the website.

See it in action

  • A file and a link on one product. You add a Product Datasheet row pointing to a URL and a User Manual row with an uploaded PDF on the product form → shoppers get both on the product page, in that order. The link sends them to your URL; the PDF opens in the browser under its own file name.

    The Product attachments panel on the product form with a URL row titled Product Datasheet and an uploaded PDF row titled User Manual

  • One title per language. You give Product Datasheet the store-view title Karta produktu → shoppers on that store view see Karta produktu, every other store view keeps Product Datasheet.

    The attachments section on a Hyvä product page listing the link Karta produktu and the User Manual PDF with its size

  • A manual per language. You put Manual (EN) on All Store Views, Handleiding (NL) on the Dutch store view and Handbuch (DE) on the German one → the Dutch product page lists the English and the Dutch manual, the German one the English and the German manual. Customers' My Attachments follows the same rule.

    The Attachments tab on the default Luma store view listing Manual (EN) and Handleiding (NL), without the German manual

  • Your words on the tab, your choice on downloads. You set Default attachment title to Documents → the product-page tab reads Documents. You set Use content-disposition to attachment → files are sent with Content-Disposition: attachment, so the browser saves them instead of opening them.

What it does

FeatureBenefit
Add attachments to a productUpload files or link external documents from the product form you already work in, in the order you want them shown
Translate attachment titles for a store viewShow each attachment under a title in the shopper's language without touching the other store views
Show an attachment in some store views onlyKeep a manual per language on one product: each store view lists its own and the shared ones, nothing else
Attachments on the product pageShoppers see every document with its title, size and icon, in the order you set, on Luma and Hyvä
My Attachments in the customer accountCustomers download the documents for everything they paid for, whenever they need them
Repair products converted to downloadableOne command finds the products an older version turned into downloadable products and makes them virtual again
Store configurationOne switch turns the feature on or off per store view; tab title, new-window behavior, open-or-download, allowed file types and tab position are yours to set
Secure downloadsEncrypted attachment ids, files typed by their extension, and downloads refused for disabled or off-website products and on store views the attachment is not assigned to

Competing solutions

The right-hand column describes common practice across the Magento extension market, not any particular vendor.

QoliberTypical marketplace extension
GitLab accessFull access to the module's GitLab repository — source, history, issues and merge requestsVaries by vendor
Packagist installationInstalled and updated with Composer from our private Packagist (qoliber.repo.packagist.com)Varies by vendor
Slack access to the development teamA shared Slack channel with the developers who build and maintain the moduleUsually ticket-based
Unit tests93 PHPUnit unit tests (17 classes) in the repositoryNot typically published
Integration tests69 Magento integration tests (13 classes), run before every releaseNot typically published
E2E Playwright tests57 Playwright end-to-end tests on Luma and Hyvä, run before every releaseNot typically published
DocumentationFull docs portal: install, configuration, usage, troubleshooting, developer guide and changelogVaries by vendor
Hyvä supportqoliber/product-attachments-hyva: Hyvä templates for the product-page section and the My Attachments pageVaries by vendor
PHP / Magento rangePHP 8.1 – 8.5, Magento Open Source and Mage-OS with magento/framework ^103.0Varies by vendor

Built for Magento, not bolted onto it

  • Hyvä-native. qoliber/product-attachments-hyva replaces the Luma templates on Hyvä storefronts, using the theme's own section and account-page styling, with real target="_blank" links instead of script handlers.
  • Nothing leaves your store. Uploaded files live in your Magento media directory and are streamed by your store; link attachments redirect to the address you entered. No third-party service is involved.
  • Translated. Interface strings ship in English and Polish.

Also available in: Polish.

Good to know

  • Attachments are managed on each product's edit form. There is no separate attachments grid and no bulk import.
  • The module has no REST or GraphQL endpoints of its own; attachments travel with the product as its product_attachments extension attribute, store views included.
  • My Attachments lists products from the customer's orders on the current website. Canceled, closed (refunded), pending-payment and payment-review orders do not count.
  • Adobe Commerce is not supported: its staging product schema is not handled.

Supported on PHP 8.1–8.5 with Magento Open Source or Mage-OS 2.4.6 and later (magento/framework ^103.0).

Ready to start? Install the extension, then configure it. For licensing and commercial questions, see partnership.

Product Attachments — Catalog & Products — Extensions | qoliber Docs