Metafield mapping
This section provides an overview of metafield mapping in the Akeneo App for Shopify.
Metafields
Shopify Metafields are additional customizable fields that can be added to various Shopify entities, such as products, variants, collections, customers, orders, and more. They allow you to extend the default functionality of Shopify by storing and displaying extra information that is not included in the standard data structure.
The app only supports metafields at the product and variant levels.
For each metafield, the app will create a definition in Shopify and import values.
You can create up to 250 Metafield definitions in Shopify with the App.
Please note that the app can only retrieve the first 10,000 attributes of your PIM. Other PIM attributes cannot be mapped.
List of supported metafield types
Each PIM attribute is transformed when synchronizing with Shopify. Please see the transformation of each attribute in the table below.
| Akeneo PIM attribute type | Shopify metafield type |
|---|---|
| Date | Date |
| Identifier | Single line text - one value |
| Simple select | Single line text - one value |
| Multi-select | Single line text - list of values |
| Measurement | Single line text - one value |
| Number | Decimal |
| Price | Money |
| Text | Single line text - one value |
| Text area | Multi-line text |
| Boolean | True or false |
- The translated label of your attribute will be imported as the attribute name.
- The App does not impact the import order of metafields in Shopify.
- If you delete product attributes in your PIM or in the App interface, those will be removed automatically from your product page in Shopify during the next import.
Follow these steps to map your metafields:
- Go to: Metafield mapping >> Select From PIM attributes >> Click on Manage Metafields
- Select PIM attributes that you want to map
- Validate your choice by clicking on Save selection
Follow these steps to remove some of the metafields from the mapping:
- Go to: Metafield mapping >> Select From PIM attributes >> Click on Manage Metafields
- Deselect PIM attributes that you want to remove from your mapping
- Validate your choice by clicking on Save selection
Please note that the app currently does not allow you to clear metafield values.
As a result, any attribute values deleted in Akeneo PIM will not be reflected in Shopify.