Product Data Mappings Setup

Product Data Mappings Setup

Product Data Mappings Setup

Map PIM attributes to BigCommerce fields.

Product Mappings

Map PIM attributes to be synced as Product Level BigCommerce fields.


Steps:
  1. Map all the required BigCommerce fields to appropriate attributes in PIM.
    1. Product Name ← Title/name attribute
    2. Product Type ← Product Type attribute
    3. Default Price ← Price attribute
    4. Weight ← Weight attribute
  2. Map the optional fields as needed, like SKU, brand, description, visibility, cost, shipping, SEO information, and more.
  3. Add default values for standard BigCommerce fields that are not managed in the PIM by clicking on “Add default value”.
  4. Click on Save Config once the mappings are finalized.

Variant Mappings

Map PIM attributes to be synced as Variant Level BigCommerce fields.

Steps:
  1. Map the Variant BigCommerce fields to appropriate attributes in the PIM.
    1. Variant SKU ← SKU attribute for variant
    2. Variant default price ← Variant Price attribute
    3. Variant Weight ← Weight attribute
    4. Variant MPN ← MPN attribute
    5. Variant Purchasable? ← Variant Purchasability attribute
  2. 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.

    1. Product Images ← Asset Collection attributes in PIM

    2. Product Images ← Standard Image attributes (files) in PIM

    3. Product Images ← Text attributes (URLs) in PIM

  • Select the attributes to be synced as Product Videos in BigCommerce.

    1. Product Videos (YouTube) ← Text attributes (URLs) in PIM

  • Map the attributes to be synced as a Variant Image in BigCommerce.

    1. Variant Image ← Asset Collection attribute in PIM

    2. Variant Image ← Standard Image attribute (files) in PIM

    3. 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:

  1. 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.

  2. 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.

  3. Click on Save Config once the mappings are finalized.

Note: Custom field values over 250 characters will be truncated.

Metafield Mapping

Map PIM attributes to BigCommerce metafields to deliver additional structured data.

​

Steps:

  1. 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.

  2. Click on Save Config once the mappings are finalized.

Product Relationship Mapping

Map PIM product associations to BigCommerce related products.

​

Steps:

  1. Map association types such as cross-sell, up-sell, etc from PIM to Related Products in BigCommerce.

  2. Click on Save Config once the mappings are finalized.

Additional Mapping


Options you will see and how to use them:

  1. 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.

  2. 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.

  3. BigCommerce Storefronts: Define which products are assigned to specific BigCommerce storefronts. This option is used when your account has multiple channels.

    1. Create a multi-select attribute in Akeneo (for example bigc_storefronts).

    2. Each option should have:

      1. Code = BigCommerce Channel ID (numeric ID)

      2. Label = readable storefront name

    3. Select the channels where the product should be available. When synced, the product will be assigned to those storefronts.

Additional Data Setup Instructions

Connector's Fields & Data Types is a reference for mapping your PIM attributes to BigCommerce fields. It shows which field types are supported, what values BigCommerce accepts, and any important limits to keep in mind. Use it as a guide to make sure your product and variant data syncs correctly every time.

Predefined Field Values by BigCommerce

Follow these allowed values exactly where required. Values are case sensitive.

Field

Allowed Values

Example

Product Type

physical or digital

physical

Condition

New, Used, Refurbished

New

Availability Text

available, disabled, preorder

available

Track Inventory

product, variant, none

product

Gift wrapping options type

any, none, list

any

Variant Purchasability

true, false

true


    • Related Articles

    • Data Filters Setup

      Data Filters Setup Define which products should be included in the sync. Steps: Open the Configuration tab and navigate to the Data Filters Section. Define the product filter criteria by selecting the standard filters like locale, currency, status, ...

    • Channel Mappings Setup

      Channel Mappings Setup Map Akeneo channels to BigCommerce storefronts. Steps: Open the Configuration tab and navigate to the Channel Mappings Section. Map the BigCommerce Storefront to PIM Channel by selecting the right storefront and channel from ...

    • Product Data Sync

      Product Data Sync Steps: Open Data Sync tab and navigate to the Product Sync section. Click on Sync Products. Note: Ensure all required fields are mapped in the product mapping.

    • What is the setup time needed for the connector?

      You can install the connector from the BigCommerce apps marketplace with a few clicks. The connector can then be configured in a few minutes. You can then start to sync product data from your Akeneo PIM into BigCommerce with a couple of clicks. The ...

    • Connection Setup

      Connector Configuration Setup the Connector Configurations under the “Configurations” tab in the Connector. Save changes by clicking on “Save Config” at the bottom of each section. Connection Setup Create a connection between the PIM & BigCommerce ...