Documentation Hub

Feed Types

Primary, Supplemental, and Local Inventory feeds for any use case

Feed Types

Max AI: Google Feed Ascend supports multiple feed types to accommodate different Google Merchant Center requirements.


Overview

Primary Feed

Main product data source with complete product information

Supplemental Feed

Override or supplement specific product attributes

Local Inventory Feed

Report local store inventory for physical locations


Primary Feed

What is a Primary Feed?

A Primary Feed is the main data source for your products in Google Merchant Center. It contains all required product attributes and serves as the foundation for your product listings.

Required Attributes

AttributeDescription
idUnique product identifier
titleProduct name
descriptionProduct description
linkProduct page URL
image_linkMain product image
availabilityStock status
priceProduct price
brandBrand name
conditionNew, Used, Refurbished

Best For

  • Initial product catalog upload
  • Complete product data sync
  • New stores starting with Google Shopping

Configuration

  1. Select "Primary Feed" when creating a new feed
  2. Configure target country and language
  3. Map all required fields
  4. Add optional fields as needed
  5. Generate and submit to Google

Supplemental Feed

What is a Supplemental Feed?

A Supplemental Feed provides additional or updated data for products that already exist in a Primary Feed. It cannot create new products - it only modifies existing ones.

Use Cases

ScenarioAttributes to Update
Price updatesprice, sale_price
Inventory syncavailability, quantity
Promotionspromotion_id
Seasonal datacustom_label, seasonal_availability
Enhanced contentproduct_detail, product_highlight

How It Works

  1. Products are matched by id (must match Primary Feed IDs)
  2. Only specified attributes are updated
  3. Unspecified attributes remain from Primary Feed

Configuration

  1. Select "Supplemental Feed" when creating
  2. Link to an existing Primary Feed
  3. Include only attributes you want to update
  4. Ensure product IDs match Primary Feed

Best Practices

  • Keep supplemental feeds focused (one purpose per feed)
  • Update frequently for price/inventory changes
  • Use for A/B testing different content

Local Inventory Feed

What is a Local Inventory Feed?

A Local Inventory Feed reports inventory data for physical store locations, enabling:

  • Local product ads
  • Store pickup options
  • "Near me" shopping experiences

Required Attributes

AttributeDescription
store_codeUnique store identifier
idProduct ID (must match Primary Feed)
quantityStock quantity at location
priceIn-store price
availabilityStock status at location

ID Matching Strategies

StrategyDescription
match_primaryMatch IDs from Primary Feed
shopify_defaultUse Shopify's default ID format
shopify_targetUse Shopify target country ID
global_skuUse global SKU
customCustom ID mapping

Location Mapping

Configure which Shopify locations map to which store codes:

{
  "locationMappings": {
    "gid://shopify/Location/123": "STORE001",
    "gid://shopify/Location/456": "STORE002"
  }
}

Setup Steps

  1. Configure physical locations in Shopify
  2. Create Local Inventory Feed
  3. Select ID matching strategy
  4. Map Shopify locations to store codes
  5. Generate and submit

Feed Comparison

FeaturePrimarySupplementalLocal Inventory
Create products
Update products
Required for GMCYesNoNo
IndependentYesNoNo
Location-specific

Choosing the Right Feed Type

Use Primary Feed When:

  • Starting fresh with Google Shopping
  • Need to upload complete product catalog
  • Want full control over all attributes

Use Supplemental Feed When:

  • Need to update prices frequently
  • Running promotions
  • Adding seasonal information
  • Testing different content

Use Local Inventory Feed When:

  • Have physical store locations
  • Want to enable local pickup
  • Running local inventory ads
  • Supporting "near me" searches

Multiple Feeds

You can create multiple feeds for different purposes:

  • Multiple Primary Feeds: Different countries/languages
  • Multiple Supplemental Feeds: Different update purposes
  • Multiple Local Inventory Feeds: Different location groups

Feed limits depend on your subscription plan. Check Pricing for details.

On this page