Local Inventory Feed Setup Guide
This guide explains how to set up and use the Local Inventory Feed in the Google Shopping Feed extension. The Local Inventory Feed enables Google Local Inventory Ads (LIA), allowing you to show real-time product availability for your physical store locations.
What is the Local Inventory Feed?
The Local Inventory Feed is a supplemental feed that provides Google with real-time stock information for your physical stores. When combined with your main product feed, it enables:
- Local Inventory Ads - Show "In store" or "Pick up today" labels in Shopping ads
- Real-time availability - Display current stock levels to nearby shoppers
- Store-specific pricing - Show different prices per store location if needed
- Omnichannel shopping - Connect online browsing with in-store purchasing
Prerequisites
Before setting up the Local Inventory Feed:
- Google Merchant Center account with Local Inventory Ads enabled
- Business Profile (formerly Google My Business) with your store locations verified
- Main product feed already configured and approved in Google Merchant Center
- Store codes matching between your Business Profile and Magento
Feed Contents
The Local Inventory Feed exports the following data for each product:
| Field | Description |
|---|---|
id |
Product identifier (matches main feed) |
store_code |
Physical store location code |
availability |
"in stock" or "out of stock" |
price |
Current product price with currency |
sale_price |
Sale price if applicable |
quantity |
Stock quantity available |
sale_price_effective_date |
Date range for sale price |
Configuration
Location: Magmodules > Google Shopping - Inventory > Feed Generation Settings
Enable the Feed
| Setting | Description |
|---|---|
| Enable | Turn on inventory feed generation for this store view |
Filename
| Setting | Description |
|---|---|
| Filename | Custom filename for the feed (default: inventory.xml) |
Each store view generates its own inventory feed file.
Store Code Configuration
The store code identifies your physical store location and must match exactly what you registered in Google Business Profile.
| Setting | Description |
|---|---|
| Store Code | Use Magento store code or custom value |
| Custom Store Code | Enter the exact store code from your Business Profile |
Important: The store code must match your Business Profile exactly. If your Business Profile uses store_nyc_001, you must use the same value here.
Setting Up Store Codes
Single Store Location
If you have one physical store:
- Set Store Code to "Custom"
- Enter your Business Profile store code in Custom Store Code
- Use the same configuration for all store views
Multiple Store Locations
If you have multiple physical stores with separate Magento store views:
- Create a Magento store view per physical location
- Configure each store view with its corresponding store code
- Enable the inventory feed for each store view
Example setup:
| Magento Store View | Custom Store Code |
|---|---|
| New York Store | store_nyc_001 |
| Los Angeles Store | store_la_002 |
| Chicago Store | store_chi_003 |
Generating the Feed
From Admin Panel
- Navigate to Magmodules > Google Shopping - Inventory
- Find the store view in the feed table
- Click Generate Inventory from the Actions dropdown
From Command Line
# Generate for all enabled store views
bin/magento googleshopping:inventory:create
# Generate for specific store view
bin/magento googleshopping:inventory:create --store-id=1
Via Cron (Automatic)
The inventory feed shares cron settings with the main feed. Configure in: Magmodules > Google Shopping - Feed > Automation
Uploading to Google Merchant Center
Option 1: SFTP Transfer (Recommended)
Enable automatic SFTP transfer to send the inventory feed directly to Google:
- Configure SFTP credentials in Magmodules > Google Shopping - Feed > SFTP Transfer
- Use Generate + Transfer action in the feed table
Option 2: Scheduled Fetch
- Download the inventory feed from the admin panel
- In Google Merchant Center, go to Products > Feeds > Supplemental feeds
- Create a new supplemental feed for local inventory
- Set up scheduled fetch with your feed URL
Option 3: Manual Upload
- Download the inventory feed
- In Google Merchant Center, go to Products > Feeds > Supplemental feeds
- Upload the feed file manually
Linking to Main Feed
The Local Inventory Feed is a supplemental feed that links to your main product feed through the id field. Ensure:
- The
idfield matches exactly between main feed and inventory feed - Products exist in your approved main feed before adding to inventory feed
- Both feeds reference the same Google Merchant Center account
Troubleshooting
Products not showing local availability
Check:
- Store code matches Business Profile exactly (case-sensitive)
- Product exists in approved main feed
- Inventory feed has been uploaded as supplemental feed
- Local Inventory Ads are enabled in Merchant Center
Stock levels not updating
Check:
- Inventory feed is regenerating (check file timestamp)
- SFTP transfer is successful (check transfer logs)
- Scheduled fetch is running (check Merchant Center fetch status)
"Store code not recognized" error
Fix:
- Verify store code in Business Profile
- Ensure store code is entered exactly as shown (including underscores, hyphens)
- Check that the store location is verified in Business Profile
Best Practices
- Frequent updates - Update inventory feed more often than main feed (hourly vs daily)
- Accurate stock - Ensure Magento stock levels reflect actual physical inventory
- Consistent IDs - Use the same product ID format in main and inventory feeds
- Test first - Verify with a few products before enabling for full catalog
- Monitor errors - Check Google Merchant Center for feed processing errors
Google Requirements
For complete Local Inventory Ads requirements, see:
Need More Help?
Documentation:
- All Help Articles - Complete documentation overview
Support:
- Contact Support - Get help from our team