Native field mapping
This section provides an overview of native field mapping in the Akeneo App for Shopify.
Native Fields
A native field refers to a predefined and built-in attribute or data field that is available within the platform's standard functionality. These fields are provided by default and are designed to store specific types of information related to products, orders, customers, and other elements of an e-commerce store.
Native fields in Shopify are ready to use without any additional customization or development work. They are integral to the core features and capabilities of the platform, enabling merchants to effectively manage their online stores.
These fields are designed to capture essential information about products, facilitate organization and searchability, enable inventory management, support marketing efforts, and enhance the overall customer experience.
Mapping
Mapping refers to the process of establishing a connection between corresponding data fields in Akeneo and Shopify. Mapping is essential to ensure that product data is correctly synchronized between the two platforms. The process involves associating Akeneo attributes with the corresponding Shopify fields.
Different types of mapping for Shopify native fields
The Akeneo App for Shopify allows you to manage your mapping in two different ways:
- Simple mapping - if your data modelization in the PIM is based on the same attributes for all PIM families then you can map one particular data source to match all your products (eg. If you use the "My_short_description" field to fill in your description for all of your products independently on their family, then you will map it using simple mapping.
- Complex mapping - this option allows you to map a Shopify target field differently for each product family. Depending on your data modelization strategy, it can be used for each target field or only for one or a few of them.
If you wish to use a complex mapping for one of the Shopify target fields, please tick the checkbox ‘Define a specific attribute for each family’ below the drop-down list. Then, click on MANAGE FAMILY MAPPING. An additional family-by-family mapping modal will appear to allow you to map a PIM attribute by family.
Be aware that you can combine both types of mapping depending on your needs. If you wish to use the complex mapping for a specific field, all you need to do is to check the corresponding checkbox and click on ‘MANAGE FAMILY MAPPING’ to access complex mapping for this specific field.
Be careful if you opt for a complex mapping for the Title field (mandatory): make sure that your mapping is completed for all concerned families before launching your first import in order to avoid unnecessary errors.
You need to click on the SAVE button in the top right corner of the page to save the changes.
Please keep in mind that to avoid any errors during your import, if you decide on the Family to Family mapping for Title, you should complete your mapping for all concerned families before launching your first import.
List of Native fields
Native fields for simple products
| Native fields | Supported PIM attributes | Limitations | |
|---|---|---|---|
| BASIC INFORMATION | |||
| Title - mandatory field | Yes |
Identifier, Text | 255 characters max |
| Description | Yes |
Text area, Text | 512 KB max size |
| MEDIA | |||
| Images | Yes |
Image, Asset collection | The limitation depends on the media source: • 15 image attributes max • 5 asset collections max - including video assets |
| Videos | Yes |
Asset collection | 5 asset collections max - including image assets |
| Image alt texts | No |
||
| PRICING | |||
| Price | Yes |
Number, Price | Values cannot be negative |
| Compare at Price | Yes |
Number, Price | |
| Taxable | Yes |
Yes/No | |
| Cost per item | Yes |
Number, Price | Values cannot be negative |
| INVENTORY | |||
| SKU | Yes |
Identifier, Text | 255 characters max |
| Barcode | Yes |
Identifier, Text | 255 characters max |
| Track quantity | Yes |
Boolean | By default, the quantity is not tracked. • Yes: track quantity • No/null: do not track quantity |
| Continue selling when out of stock | No |
||
| SHIPPING | |||
| Physical | Yes |
Yes/No | |
| HS code | Yes |
Identifier, Text | between 6 and 13 digits |
| Weight | Yes |
Measurement, Number | 2 000 000 000 unit max |
| Country/Region of origin | No |
||
| SEARCH ENGINE LISTING | |||
| Page title | Yes |
Text | 70 characters max |
| Meta description | Yes |
Text, Text area | 320 characters max |
| URL handle | Yes |
Text | 255 characters max Value cannot contain spaces. |
| STATUS | |||
| Status | Yes | Simple select |
There are three possible statuses: • ACTIVE |
| PRODUCT ORGANIZATION | |||
| Product type | Yes |
Text, Simple select | 255 characters max |
| Vendor | Yes |
Text, Simple select | 255 characters max |
| Tags | Yes |
Simple select, Multi select | 250 tags max |
Native fields for product models
| Native fields | Supported PIM attributes | Limitations | |
|---|---|---|---|
| BASIC INFORMATION | |||
| Title - mandatory field | Yes |
Identifier, Text | 255 characters max |
| Description | Yes |
Text area, Text | 512 KB max size |
| MEDIA | |||
| Images | Yes |
Image | The limitation depends on the media source • 15 image attributes max • 5 asset collections max - including video assets |
| Videos | Yes |
Asset collection | 5 asset collections max - including image assets |
| Image alt texts | No |
||
| SEARCH ENGINE LISTING | |||
| Page title | Yes |
Text | 70 characters max |
| Meta description | Yes |
Text area, Text | 320 characters max |
| URL handle | Yes |
Text | 255 characters max. Value cannot contain spaces. |
| STATUS | |||
| Status | Yes | Simple select |
There are three possible statuses: • ACTIVE |
| Product type | Yes |
Text, Simple select | 255 characters max |
| Vendor | Yes |
Text, Simple select | 255 characters max |
| Tags | Yes |
Simple select, Multi select | 250 tags max |
Native fields for product variants
| Native fields | Supported PIM attributes | Limitations | |
|---|---|---|---|
| MEDIA | |||
| Image | Yes |
Image, Asset collection |
The limitation depends on the media source: • 1 image attribute max |
| PRICING | |||
| Price | Yes |
Number, Price | Values cannot be negative |
| Compare at Price | Yes |
Number, Price | |
| Taxable | Yes |
Yes/No | |
| Cost per item | Yes |
Number, Price | Values cannot be negative |
| INVENTORY | |||
| SKU | Yes |
Identifier, Text | 255 characters max |
| Barcode | Yes |
Identifier, Text | 255 characters max |
| Track quantity | Yes |
Boolean | By default, the quantity is not tracked. • Yes: track quantity • No/null: do not track quantity |
| Continue selling when out of stock | No |
||
| SHIPPING | |||
| Physical | Yes |
Yes/No | |
| HS code | Yes |
Identifier, Text | between 6 and 13 digits |
| Weight | Yes |
Measurement, Number | 2 000 000 000 unit max |
| Country/Region of origin | No |