Native field mapping

Summary

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
• DRAFT
• ARCHIVED

If not mapped, the status will be set by default depending on the PIM product status (see details here)

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
• DRAFT
• ARCHIVED

If not mapped, the status will be set to ACTIVE by default (see details here)

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 
1 asset collection 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