Quick Start

Quick start

The safest first feed has one store view, no upload destination, no schedule, and a small set of known products. Generate it, inspect it, correct it, then add automation.

Documentation baseline: public repository commit b77605d. Last reviewed: 2026-08-29.

1. Open feed management

In the Admin, go to Catalog > Mage-OS Shopping Feed > Feeds Management.

2. Create a feed

Choose one of the available templates:

• Generic for a custom delimited product feed
• Google Shopping for a Google product data source
• Google Local Inventory for location-specific inventory data

Google Promotions are configured inside a Google Shopping feed rather than created as a fourth feed type in the New Feed menu.

3. Set the feed identity

On General Configuration:

1. Enter a clear Admin name.
2. Select the store view.
3. Select the feed currency.
4. Keep the output under pub/media/mageos-shopping-feed.
5. Review delimiter and stock behavior.
6. Save before configuring fields that depend on the current column map.

4. Review the default columns

Open Columns Map. A template supplies defaults, but they are only a starting point. Confirm the source for identifiers, URLs, prices, availability, images, taxonomy, and variant data against the target store.

5. Limit the first test

Use a known SKU that represents the catalog behavior you need to prove. Good fixtures include:

• A simple product at regular price
• A simple product with an active sale price
• An out-of-stock product
• A configurable product with at least two variants
• An MSI product assigned to more than one source, for Local Inventory

Use Test Feed from the feed grid, or run:

bin/magento mage-os:shopping-feed:generate <feed_id> <sku>

Compare each output value with the Admin product, store view, price, category, URL, and inventory state.

6. Generate the file

Use Run Now to add the feed to the queue. Magento cron processes queued work. Follow status changes in the grid and inspect View Log if processing fails.

For a direct CLI run of one feed:

bin/magento mage-os:shopping-feed:generate <feed_id>

7. Inspect before automating

Check:

• Header names and column order
• Row column counts
• Product count and skipped count
• IDs, URLs, prices, sale dates, availability, and images
• Configurable parent and child behavior
• Delimiter handling for quotes, tabs, commas, line breaks, and Unicode
• The file location and public URL, if one is shown

Only after the file is accepted should you add schedules or upload destinations.