Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Contact Us
English (US)
US English (US)
FI Finnish
  • Home

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

Written by Petro Mäntylä

Updated at April 15th, 2025

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • AI Commerce
    Administration homepage Customer relationships Orders Order management Categories Quotation tool Products Configurations Modules Local regulations and taxes Front page FAQ -työkalu Tools Box Additional functions Svelte
  • Akeneo
  • Builder.io
  • Algolia
  • Google
  • Partners
  • Tuki
+ More

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

  1. Go to Akeneo's settings (Settings → Attributes).
  2. Press Create Attribute to create a new attribute .
  3. Select type : File .
  4. 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.
  5. Name the attribute descriptively, e.g. PDF file (1), PDF file (2), etc.
  6. 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.
  7. File size limit:
    • Generally, a maximum of 10 MB (megabytes) per file is recommended.
  8. 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)

  1. Open Products → Families .
  2. Select the family to which you want to add new attributes.
  3. 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.
  4. 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.

  1. Open the product and make sure that the product belongs to the correct family where these new attributes are.
  2. Go to the product card attribute editing view .
  3. Select the pdf_1 field, for example, and upload the file you want (as long as it is of an allowed type).
  4. Repeat for other attributes (pdf_2, pdf_3...) if necessary.
  5. 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:

  1. Go to the family's Attributes tab.
  2. Drag & drop or edit the order so that pdf_1...pdf_5 are in the desired position.
  3. 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

  1. Create File-type attributes (pdf_1, pdf_2, ies_1, etc.) and allow the desired file formats for them.
  2. Add these attributes to each family so they appear in products.
  3. Upload the files with product cards (Akeneo) and make sure that the restrictions (size limit, file extension) match.
  4. Sync products to AI Commerce : the files will appear in the “Attachments” section of the product card.
  5. 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.

akeneo product attachments

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • How to create families and variant families in Akeneo?
  • How to create families and variant families in Akeneo?
  • How do you activate a Klarna invoice?
  • How does Lemonsoft customer account synchronization work?
  • How to view a product's transaction history in the AI Commerce dashboard?

Copyright 2025 – AI Commerce Cloud.

Knowledge Base Software powered by Helpjuice

Expand