SHopify Index

2. Index Feed

Unbxd will connect to your specific Shopify store and index your product and collection data on an Unbxd site. Refer to the table below for details on the attributes.

Product Information

The following product-level fields are fetched and mapped to Unbxd by default. No additional configuration is required.

Shopify Field	Unbxd Field	Notes
id	uniqueId	Last segment of Shopify GID
descriptionHtml	descriptionHtml	Unchanged
createdAt	createdAt	Normalised to UTC ISO
handle	productUrl, handle	URL built as `/products/{handle}`; handle retained
featuredImage.originalSrc	imageUrl	Main product image URL
featuredImage.altText	imageUrlAltText	Alt text for main image
images	images	Full image structure unchanged
productType	productType	Unchanged
publishedAt	publishedAt	Normalized to UTC ISO
tags	tags, tags_*	Tags retained; key:value tags expanded into derived fields
templateSuffix	templateSuffix	Unchanged
totalInventory	totalInventory	Also used in availability calculation
tracksInventory	availability	True if tracking and `totalInventory > 0`; True if not tracking
title	title	Unchanged
vendor	vendor	Unchanged
productCategory.productTaxonomyNode.fullName	productCategory_fullName	Flattened
productCategory.productTaxonomyNode.name	productCategory_name	Flattened
updatedAt	updatedAt	Normalized to UTC ISO
isGiftCard	isGiftCard	Unchanged
collections	collections	Unchanged

Variant Information

Variant data is fetched alongside product data. All variant fields are prefixed with v_ in Unbxd. No additional configuration is required.

Shopify Field	Unbxd Field	Notes
id	variantId	Last segment of GID
compareAtPrice	v_compareAtPrice	Decimal format
createdAt	v_createdAt	UTC ISO format
image.originalSrc	v_imageUrl	URL only
inventoryQuantity	v_inventoryQuantity	Unchanged
selectedOptions	v_selectedOptions, v_`OptionName`	Expanded per-option fields
inventoryPolicy	v_inventoryPolicy	Unchanged
price	v_price	Decimal format
requiresShipping	v_requiresShipping	Unchanged
sku	v_sku	Unchanged
taxable	v_taxable	Unchanged
taxCode	v_taxCode	Unchanged
title	v_title	Unchanged
updatedAt	v_updatedAt	UTC ISO format
weight	v_weight	Unchanged
weightUnit	v_weightUnit	Unchanged
availableForSale	v_availableForSale	Used in availability summary calculation

Metafields Support

Default Supported Metafield Types are below

All metafields are automatically indexed as new Unbxd fields, prefixed with meta_. The following datatypes are supported by default:

number_integer
- list.number_integer
  - number_decimal
    - list.number_decimal
      - list.single_line_text_field
        
        list.url
        
        list.color
        
        string
        
        json
        
        color
        
        multi_line_text_field
        
        single_line_text_field
        
        url

Additional Datatypes (Requires Configuration)

The following datatypes require special configuration to be extracted:

file_reference
- metaobject_reference
  
  Fields derived from these datatypes are stored in Unbxd with a datatype of link.
  
  📘
  Note
  Fetching referenced data such as swatch images or hex codes from metaobject references requires additional configuration. Please contact the Netcore Unbxd support team to enable this.

Variant Metafields

Variant-level metafields are not fetched by default. This feature can be enabled through a simple transformer configuration with no additional parameters required. Configuration Required: Yes

Collections (Categories)

Shopify collections are synced and mapped to Unbxd category fields by default.

Shopify Field	Unbxd Field
handle	category_handle
title	category

Collections as a Separate Content Type (Banners)

In addition to category mapping, Shopify collections are also synced as a separate content type in Unbxd. This enables use cases like banner display and collection-level merchandising.

Synced Fields

id
- title
  - handle
    - updatedAt
      - imageUrl
        
        imageAltText
        
        productsCount
        
        description
        
        seo_title
        
        seo_description

Price Processing

At the Product (Parent) Level The following computed price fields are available by default on each product:
- compareAtPrice = compare-at-price of variant with minimum price
  - computed_discount = ceil((compareAtPrice - price) / compareAtPrice * 100) 2. Variant Level (Default fetch)
    - computed_discount applied per variant using the same formula

Tag Processing

By default, the plugin splits Shopify tags using : as a delimiter and creates derived fields in Unbxd. All derived tag fields are prefixed with tags_. For example, a tag like color: red creates a field tags_color with value red.

Delimiter is configurable: any character can be used
- Schema for derived fields can be modified from the Unbxd Admin Panel
  Configuration is not required for this.

Availability Logic

Unbxd computes product availability based on variant-level data. Two custom fields are added automatically:

Custom Fields Added (Default behaviour).

availableForSaleOfVariants True if any variant has availableForSale = True
- availability (final product availability) True only if: totalInventory > 0, and availableForSaleOfVariants = True