Articles on: BigCommerce

Custom Field (Bigcommerce)

Configure, map, and export BigCommerce custom fields to synchronize unique product attributes, combined metadata, and auto-generated custom field values.


Available on: ✔️ Export



How to Set Up BigCommerce Custom Fields


Go to App → Feed Settings → Step 2: Matching Column → Custom Field


  1. Add Custom Field: Click to add a new custom field mapping row for your BigCommerce store.
  2. Select and Map Column: Choose the custom field from the dropdown and map it to your target export feed column.
  3. Define Field Name & Value: Enter the custom field name and specify the values or column variables to export.
  4. Enable Auto-Create (Optional): Toggle on Auto-create a new custom field if not found if you want missing custom fields created automatically.


You can add as many custom fields as needed for your BigCommerce product catalog.



BigCommerce Custom Fields Smart Settings


1. Custom Field Mapping & Setup

Map store custom fields directly to outgoing feed columns. This allows BigCommerce merchants to export unique product specifications, identifiers, or warehouse attributes that standard product fields do not cover.


Custom fields are supported specifically in export feeds to output store-defined attributes.


For example: Map a BigCommerce custom field named Material to export fabric composition values into a dedicated feed column.


2. Combined Value Mapping

Combine multiple data points into a single custom field export column using template tags.


For example: Use {{sku}}:{{units}} to merge the SKU and available units into one formatted custom field value (e.g., TSHIRT-BLK-S:25).


3. Auto-Create New Custom Field

Automatically creates the custom field in BigCommerce if it does not already exist when running the feed.


Auto-Create Custom Field Setting


To enable automatic creation, switch the Auto-create a new custom field if not found toggle to active.


For example: If your template defines a new field named Warranty_Period that is not present on the product, enabling this toggle will generate it automatically in BigCommerce.



Key Rules & Technical Details


  • Supported Feed Types: Custom field mapping for BigCommerce is supported exclusively in Export feeds.
  • Priority Sequence:
Priority sequence: Field Definition → Syntax Parsing (e.g., Template Variables {{variable}}) → Auto-Creation Check → Column Export Generation
  • Variable Syntax: Ensure variable tags match your store attribute headers exactly (e.g., {{sku}}, {{units}}). Typos inside double curly braces will prevent dynamic values from rendering.



Troubleshooting Steps


  • Issue: Custom fields are not appearing in the exported file → Solution: Verify that the custom field name is correctly defined in Step 2 and that the corresponding products in BigCommerce contain values for that field.
  • Issue: Combined mapping exports raw text instead of dynamic values → Solution: Check that variable names inside curly braces match the exact field keys (e.g., {{sku}} instead of {sku} or {{SKU_ID}}).
  • Issue: New custom fields fail to appear on BigCommerce products → Solution: Ensure the toggle for Auto-create a new custom field if not found is turned on in the field settings.



Good Articles to Continue


Updated on: 05/11/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!