Adding product attachments in Akeneo
How to manage and add media files (PDF, IES, CAD, etc.) in Akeneo so that they migrate to AI Commerce platform
In this article, you will learn how to create Akeneo attributes for multiple file types (e.g. PDF, IES, CAD, ZIP) so that you can add these media files to products and sync them with AI Commerce . This allows you to manage product documents, user manuals, and other materials without having to upgrade to a more expensive Akeneo version or install additional modules.
1. Create media file attributes
- Go to Akeneo's settings (Settings → Attributes).
- Press Create Attribute to create a new attribute .
- Select type : File .
-
Specify code:
- Use the agreed naming convention, e.g. pdf_1 , pdf_2 , ies_1 , ies_2 , etc.
- This way, AI Commerce can retrieve and display the file as the correct media.
- Name the attribute descriptively, e.g. PDF file (1), PDF file (2), etc.
-
Allowed extension:
- Just set the desired file formats (e.g.
pdf
if the attribute is for PDF files). - Other possible:
jpg
,png
,doc
,xls
,ies
,zip
,mp4
etc.
- Just set the desired file formats (e.g.
-
File size limit:
- Generally, a maximum of 10 MB (megabytes) per file is recommended.
- Save the attribute and repeat these steps as many times as you need (e.g. 1–10 PDF attributes, 1–10 IES attributes, etc.).
Note!
Use a code structure like pdf_1 , pdf_2 ... pdf_10 . AI Commerce has built-in support for these “prefix_index”-style attribute codes.
2. Add attributes to families (Families)
- Open Products → Families .
- Select the family to which you want to add new attributes.
- Add each created file attribute to your desired attribute group , e.g. AI Commerce Default , so that they appear correctly in AI Commerce on the Media tab.
- Save the changes.
Multiple families at once?
If you have multiple families (more than 10), we recommend using a CSV or XLSX import to make it faster to add attributes to all families. Use this bulk import to set the same media attributes for each family.
3. Manage allowed file types and restrictions
- At the time of writing, the allowed file types include the following. You can find a complete list in the AI Commerce media files help article.
pdf, ies, dwg, dxf, doc, docx, xls, xlsx, zip, jpg, png, gif, svg, mp4, avi, mp3, webm , etc. - Always remember to set the attribute 's Allowed extension field to only the extension you want it to accept (e.g.
pdf
only for the PDF attribute). - It is recommended to set the size limit (Max file size) to, for example, 10 megabytes.
- If you want to support CSV files, for example, create a separate attribute for them like csv_1 and allow
csv
in it.
4. Add attributes to products
Once the attributes are in families, you can add files to product cards.
- Open the product and make sure that the product belongs to the correct family where these new attributes are.
- Go to the product card attribute editing view .
- Select the pdf_1 field, for example, and upload the file you want (as long as it is of an allowed type).
- Repeat for other attributes (pdf_2, pdf_3...) if necessary.
- Save the product card.
Check the final result
AI Commerce will retrieve these files from the pdf_1, pdf_2... fields and display them on the product card. You can immediately see if the file was transferred correctly by checking the media files tab in the dashboard.
Do not use the store interface as the primary check point , as the store interface caches are not always reset as soon as a product change occurs in Akeneo. The dashboard displays real-time product information from the database.
5. Arrange the attributes in the desired order
For example, if you want PDF files to appear below the Additional Images section in the Akeneo family editor:
- Go to the family's Attributes tab.
- Drag & drop or edit the order so that pdf_1...pdf_5 are in the desired position.
- Save.
You can use the same logic for all other extensions (IES, DWG, ZIP...).
6. Limitations: Community Edition does not support more complex management
- In Akeneon Community Edition, each media file requires its own attribute (e.g. pdf_1...pdf_10 ).
- Categorization (like “Certificates”, “Manuals”) cannot be done directly in Akeneo – it must be done in AI Commerce if you want to separate files into groups.
- If you have a lot of products and a lot of media files, it's a good idea to automate this process to CSV import if possible. AI Commerce is coming with media file management via CSV. At the time of writing, product images can be imported via CSV.
7. Summary
- Create File-type attributes (pdf_1, pdf_2, ies_1, etc.) and allow the desired file formats for them.
- Add these attributes to each family so they appear in products.
- Upload the files with product cards (Akeneo) and make sure that the restrictions (size limit, file extension) match.
- Sync products to AI Commerce : the files will appear in the “Attachments” section of the product card.
- Categorize files in AI Commerce if you want to sort attachments (e.g. “Manuals”, “Certificates”).
This allows you to manage multiple media files without plugins or a more expensive version of Akeneo: one attribute per file, up to 10 files per type. This ensures that documents and other media are transferred to AI Commerce correctly and are clearly displayed there.