This article lists all reserved attributes in AI Commerce and Akeneo integration. They should not be used for other purposes, as AI Commerce utilizes them for built-in business logic (e.g. freight calculators, tax calculations, product inventory management). If you have already used any of these attributes for other purposes, remove or reset them in Akeneo or update your processes according to the default logic of AI Commerce .

Reserved attributes

1. sku
2. brand
3. material
4. extra_image_1 – extra_image_10
5. name
6. availability_in_stock
7. availability_out_of_stock
8. model_name
9. ean
10. image
11. weight
12. cargo_weight
13. width
14. length
15. height
16. status
17. short_description
18. store_description
19. description
20. video_link
21. link_href
22. link_title
23. products_location
24. vat_rate
25. price_current
26. price_purchase
27. price_business
28. shipping_fee
29. pdf
30. pdf_extra
31. package_size
32. package_unit
33. products_group
34. is_forced_stock_check
35. comment_instructions
36. variant_image
37. color_specification
38. date_available
39. products_link_href
40. products_link_title
41. sort 
     

Reserved media file attributes (1-10 each)

AI Commerce also supports many file-based attributes, 1-10 of each. These are intended as attachments to be displayed on the product card (e.g. PDF instructions, CAD files, videos). The same logic applies: do not use these for your own purposes if you want to take advantage of AI Commerce 's built-in media handling. Media files have their own help articles in both AI Commerce and Akeneo.

• pdf_1 – pdf_10
• jpg_1 – jpg_10
• jpeg_1 – jpeg_10
• avif_1 – avif_10
• png_1 – png_10
• gif_1 – gif_10
• webp_1 – webp_10
• txt_1 – txt_10
• doc_1 – doc_10
• docx_1 – docx_10
• xls_1 – xls_10
• xlsx_1 – xlsx_10
• svg_1 – svg_10
• less_1 – less_10
• ies_1 – ies_10
• dwg_1 – dwg_10
• dxf_1 – dxf_10
• dwf_1 – dwf_10
• dwfx_1 – dwfx_10
• zip_1 – zip_10
• mp4_1 – mp4_10
• avi_1 – avi_10
• mp3_1 – mp3_10
• wav_1 – wav_10
• ogg_1 – ogg_10
• flac_1 – flac_10
• mov_1 – mov_10
• m4a_1 – m4a_10
• m4v_1 – m4v_10
• webm_1 – webm_10
• mkv_1 – mkv_10
• m3u8_1 – m3u8_10
• ts_1 – ts_10

The attribute codes listed above are therefore reserved for AI Commerce , and they have underlying logic that presents attached files (such as PDF instructions or IES light files) on the product card.

What does each Akeneo attribute relate to in AI Commerce ?

• width, length, height – freight calculators and logic related to shipping dimensions
• vat_rate – product VAT rate
• price_current – basic price (b2c)
• price_business - price for business customers (b2b)
• price_purchase - purchase price
• pdf_1 – pdf_10 (etc. file prefixes) – documents, instructions, drawings, videos…
• status – product activity
• sku, ean – unique identifiers
• products_location – shelf/warehouse location
• availability_in_stock/out_of_stock – stock availability representation
• shipping_fee – product-specific shipping cost management
• comment_instructions - text attribute that overrides the instructions in the comment field displayed on the product card
• sort - the order of products in categories, if the order is chosen by the merchant
• etc.

All of these are linked at the coding level in AI Commerce to the purchasing process, inventory management, shipping calculations, or visibility on product pages.

If you accidentally used an attribute for another purpose

1. Reset the attribute from the product values (e.g. by deleting the file, clearing the value).
2. Remove the attribute from Akeneo or leave it only in the sense that AI Commerce designed it for.
3. If you wish, you can create your own, new attribute (with the code oma_tarkoitus_1 , etc.) if you want to implement the same thing without AI Commerce 's internal logic.

Summary

• Do not use reserved codes for any other purpose. These include sku , weight , vat_rate , pdf_1..pdf_10 and all other codes listed above.
• AI Commerce utilizes these fields in its internal logic: taxes, freight, inventory management, product card media files, etc.
• If you accidentally “overwrite” them with your own values, AI Commerce 's functions may stop working as expected.
• If necessary, delete or reset the value, and reconfigure it to match AI Commerce 's default behavior.

This ensures that the business logic built into AI Commerce works smoothly and that your own additional attributes do not interfere with the platform's.