Product Data Mappings Setup
Product Data Mappings Setup
Product Mappings
- Map all the required BigCommerce fields to appropriate attributes in PIM.
- Product Name ← Title/name attribute
- Product Type ← Product Type attribute
- Default Price ← Price attribute
- Weight ← Weight attribute
- Map the optional fields as needed, like SKU, brand, description, visibility, cost, shipping, SEO information, and more.
- Add default values for standard BigCommerce fields that are not managed in the PIM by clicking on “Add default value”.
- Click on Save Config once the mappings are finalized.
Variant Mappings
- Map the Variant BigCommerce fields to appropriate attributes in the PIM.
- Variant SKU ← SKU attribute for variant
- Variant default price ← Variant Price attribute
- Variant Weight ← Weight attribute
- Variant MPN ← MPN attribute
- Variant Purchasable? ← Variant Purchasability attribute
- Click on Save Config once the mappings are finalized.
Image & Video Mappings
Map the PIM asset collection attributes, standard image or text attributes to be synced as Product/Variant images and video URLs in BigCommerce.
Steps:
Select the attributes to be synced as Product Images in BigCommerce.
Product Images ← Asset Collection attributes in PIM
Product Images ← Standard Image attributes (files) in PIM
Product Images ← Text attributes (URLs) in PIM
Select the attributes to be synced as Product Videos in BigCommerce.
Product Videos (YouTube) ← Text attributes (URLs) in PIM
Map the attributes to be synced as a Variant Image in BigCommerce.
Variant Image ← Asset Collection attribute in PIM
Variant Image ← Standard Image attribute (files) in PIM
Variant Image ← Text attribute (URLs) in PIM
Click on Save Config once the mappings are finalized.
Modifier & Custom Field Mapping
Map PIM attributes to be synced as a Modifier Option and Custom Fields in BigCommerce.
Steps:
Select the attributes to be synced as Modifier Options in BigCommerce. Supported PIM data types include simple select, boolean, text, text area, number and date.
Select the attributes to be synced as Custom fields in BigCommerce. Supported PIM data types include text, text area, number, date, simple & multi select, reference entity, and measurements.
Click on Save Config once the mappings are finalized.
Note: Custom field values over 250 characters will be truncated.
Metafield Mapping
Select the attributes to be synced as product & variant metafields in BigCommerce. Supported PIM data types include text, text area, boolean, number, date, simple & multi select, identifier, metric, table, and reference entity.
Click on Save Config once the mappings are finalized.
Product Relationship Mapping
Map association types such as cross-sell, up-sell, etc from PIM to Related Products in BigCommerce.
Click on Save Config once the mappings are finalized.
Additional Mapping
Import images during product updates?: Control whether images are synced by selecting Yes or No from the dropdown. This setting applies to the next sync.
Track Inventory: Set or update the Inventory Tracking flag by mapping an attribute with values product, variant, or none. This defines whether inventory tracking is enabled and at which level it is applied.
BigCommerce Storefronts: Define which products are assigned to specific BigCommerce storefronts. This option is used when your account has multiple channels.
Create a multi-select attribute in Akeneo (for example bigc_storefronts).
Each option should have:
Code = BigCommerce Channel ID (numeric ID)
Label = readable storefront name
Select the channels where the product should be available. When synced, the product will be assigned to those storefronts.
Additional Data Setup Instructions
Predefined Field Values by BigCommerce
Follow these allowed values exactly where required. Values are case sensitive.