Ads and product feeds: the parts, in plain words

41 parts and 16 phrases. Apps in this area include Google Merchant Center, Meta Commerce Manager, TikTok Catalog, Pinterest Catalogs, DataFeedWatch, Feedonomics.

Feed itemsfeeds.itemShowWhat one product looks like inside a channel's catalogue.

Required item fieldsfeeds.item.requiredShowThe fields every channel needs for one item.

How to extend

Core onlyThe base field mapping comes from the catalogue and stays in core so every channel reads the same price and stock.

Part	Litestore today	How to extend
Item id`feeds.item.required.id`The item id is the unique code for one variant in the channel, taken from its SKU.	Core`modules/integrations/merchant/product-mapper.ts`	Core only
Item title`feeds.item.required.title`The item title is the product name plus the variant label, cut to the channel's length limit.	Core`modules/integrations/merchant/product-mapper.ts`	Core only
Item description`feeds.item.required.description`The item description is the product description with formatting removed.	Core`modules/integrations/merchant/product-mapper.ts`	Core only
Product link`feeds.item.required.link`The product link is the web address of the product page on the store.	Core`modules/integrations/merchant/product-mapper.ts`	Core only
Main image link`feeds.item.required.image`The main image link points to the product's first picture.	Core`modules/integrations/platforms/product-sync.ts`	Core only
Price`feeds.item.required.price`The price field holds the variant's regular price and currency.	Core`modules/integrations/merchant/product-mapper.ts`	Core only
Sale price`feeds.item.required.sale_price`The sale price field is filled only while the variant's sale window is live.	Core`modules/integrations/merchant/product-mapper.ts`	Core only
Availability`feeds.item.required.availability`The availability field says in stock or out of stock, read from the variant's available count.	Core`modules/integrations/platforms/product-sync.ts`	Core only
Condition`feeds.item.required.condition`The condition field marks the item as new, used or refurbished.	Core`modules/integrations/merchant/product-mapper.ts`	Core only
Brand`feeds.item.required.brand`The brand field names the maker of the item.	Core`modules/integrations/merchant/product-mapper.ts`	Core only

Extra item fieldsfeeds.item.extraShowFields that improve how an item is matched and shown.

How to extend

ProviderMany side by sidecatalogue channelA channel plugin fills the extra fields its channel reads.

Part	Litestore today	How to extend
Global barcode number`feeds.item.extra.global_barcode`The global barcode field holds the item's GTIN, which channels use to match it to a known product.	Plugin	Provider · many
Manufacturer part number`feeds.item.extra.part_number`The part number field holds the manufacturer's part number (MPN), sent here as the SKU.	Core`modules/integrations/merchant/product-mapper.ts`	Provider · many
Product type`feeds.item.extra.product_type`The product type field holds the store's own category path, such as Clothing > Shirts.	Core`modules/integrations/merchant/product-mapper.ts`	Provider · many
Channel category id`feeds.item.extra.channel_category`The channel category field holds a category id from the channel's own published category list, such as Google's product taxonomy.	Plugin	Provider · many
Item group id`feeds.item.extra.item_group`The item group id ties the variants of one product together so the channel shows them as one product.	Plugin	Provider · many
Extra image links`feeds.item.extra.additional_images`The extra image links field lists further product pictures after the main one.	Plugin	Provider · many
Shipping cost and weight`feeds.item.extra.shipping`The shipping fields hold the delivery cost per country and the item's weight.	Plugin	Provider · many
Structured product data`feeds.item.extra.structured_data`Structured product data is the product's facts, price, stock and return policy written in schema.org form for search engines and shopping agents.	Core`app/api/products/feed/route.ts`	Provider · many

Destinationsfeeds.destinationShowThe channels the catalogue is sent to and how it gets there.

How to extend

ProviderMany side by sidecatalogue channelA plugin adds another channel, such as a video app or an image network, beside the built-in ones.
EventMany side by sideevent.product.published event.product.updated event.product.archivedA channel plugin pushes a product again when it is published, edited or archived.

Part	Litestore today	How to extend
Search engine shopping catalogue`feeds.destination.search_engine_shopping`This connection sends each published variant to a search engine's shopping catalogue through its API; Litestore sends to Google Merchant Center today.	Core`modules/integrations/platforms/google-merchant.ts`	Provider · manyEvent · many
Social network catalogue`feeds.destination.social_network_catalog`This connection sends each published variant to a social network's product catalogue through its API; Litestore sends to Meta's catalogue for Facebook and Instagram today.	Core`modules/integrations/platforms/meta-commerce.ts`	Provider · manyEvent · many
Video app catalogue`feeds.destination.video_app_catalog`This connection sends products to a short-video app's catalogue for its in-app shop and catalogue ads.	Plugin	Provider · manyEvent · many
Image network catalogue`feeds.destination.image_network_catalog`This connection sends products to an image-sharing network's catalogue for product posts and shopping ads.	Plugin	Provider · manyEvent · many
Feed file address`feeds.destination.file_url`A feed file address is a web address that returns the whole catalogue as a file a channel reads on a schedule.	Core`app/api/products/feed/route.ts`	Provider · manyEvent · many
Push on change`feeds.destination.push_on_change`Push on change sends a product to every connected channel again when it is published or edited.	Core`jobs/domain-events.ts`	Provider · manyEvent · many
Sync now`feeds.destination.manual_sync`Sync now sends the whole published catalogue to a connected channel when staff press the button.	Core`modules/integrations/admin/actions.ts`	Provider · manyEvent · many
Remove from channel`feeds.destination.delist`This step deletes an item from the channel's catalogue when the product is archived or deleted in the store.	Plugin	Provider · manyEvent · many
Stock change push`feeds.destination.stock_push`A stock change push sends a variant's new availability to the channels as soon as its stock changes.	Plugin	Provider · manyEvent · many

Rules and labelsfeeds.transformShowReshaping the catalogue per channel without changing the products.

How to extend

ProviderOne per storefeed managerA feed manager plugin owns the rules, labels and extra feeds for all channels.

Part	Litestore today	How to extend
Feed rule`feeds.transform.rule`A feed rule changes a field's value for one channel, such as adding the brand to the start of every title.	Plugin	Provider · one
Exclusion rule`feeds.transform.exclude`An exclusion rule leaves matching items out of one channel's catalogue, such as items under a set price.	Plugin	Provider · one
Custom label`feeds.transform.custom_label`A custom label is a free field, such as margin band or season, used to group items into ad campaigns.	Plugin	Provider · one
Supplemental feed`feeds.transform.supplemental`A supplemental feed is a second file keyed by item id that adds or overrides fields in the main feed.	Plugin	Provider · one
Store-wide defaults`feeds.transform.default_values`Store-wide defaults set one brand, condition and country for every item that has no value of its own.	Core`modules/integrations/merchant/product-mapper.ts`	Provider · one

Diagnosticsfeeds.statusShowWhat the channel accepted or rejected, and why.

How to extend

SlotMany side by sideadmin.slot.product.blockA channel plugin shows an item's approval state and issues on the product page in the admin.

Part	Litestore today	How to extend
Last sync result`feeds.status.last_sync`The last sync result stores when the catalogue was last sent successfully and the errors from the latest attempt.	Core`modules/integrations/platforms/product-sync.ts`	Slot · many
Item approval state`feeds.status.item_approval`The item approval state shows whether the channel approved, rejected or is still reviewing each item.	Plugin	Slot · many
Item issues`feeds.status.item_issues`Item issues list each problem the channel found on an item, such as a missing GTIN or a price that differs from the page.	Plugin	Slot · many
Account warning`feeds.status.account_warning`An account warning is a message from the channel about the whole store, such as a policy breach that can stop all listings.	Plugin	Slot · many

How channels use the cataloguefeeds.ad_useShowThe placements a sent catalogue feeds on each channel.

How to extend

Core onlyPlacements are run inside each channel's own ad tools; Litestore only supplies the catalogue.

Part	Litestore today	How to extend
Free listing`feeds.ad_use.free_listing`A free listing shows an item on the channel's shopping pages without an ad payment.	Plugin	Core only
Shopping ad`feeds.ad_use.shopping_ad`A shopping ad is a paid placement that shows an item's picture, title and price from the catalogue.	Plugin	Core only
Catalogue ad`feeds.ad_use.catalogue_ad`A catalogue ad fills an ad template with items from the catalogue, choosing items per viewer.	Plugin	Core only
Retargeting match`feeds.ad_use.retargeting_match`A retargeting match pairs the item ids in the store's tracking events with catalogue ids so viewed items can be shown again in ads.	Plugin	Core only
In-app shop`feeds.ad_use.shop_tab`An in-app shop shows the catalogue as a browsable shop inside a social app's profile.	Plugin	Core only

Phrase	Made of
product feed	feeds.destination.file_url feeds.item.required.id feeds.item.required.price feeds.item.required.availability
catalog sync	feeds.destination.push_on_change feeds.destination.manual_sync feeds.status.last_sync
free listings	feeds.destination.search_engine_shopping feeds.ad_use.free_listing
Google Shopping feed	feeds.destination.search_engine_shopping feeds.item.required.id feeds.item.extra.channel_category
dynamic product ads	feeds.destination.social_network_catalog feeds.ad_use.retargeting_match feeds.ad_use.catalogue_ad
Advantage+ catalog ads	feeds.destination.social_network_catalog feeds.ad_use.retargeting_match feeds.ad_use.catalogue_ad
custom labels	feeds.transform.custom_label
supplemental feed	feeds.transform.supplemental
feed rules	feeds.transform.rule feeds.transform.exclude
disapproved products	feeds.status.item_approval feeds.status.item_issues
Merchant Center diagnostics	feeds.status.item_issues feeds.status.account_warning
Instagram Shopping	feeds.destination.social_network_catalog feeds.ad_use.shop_tab
TikTok catalog	feeds.destination.video_app_catalog
Pinterest product pins	feeds.destination.image_network_catalog
variant grouping in feeds	feeds.item.extra.item_group
schema.org product data	feeds.item.extra.structured_data

Ads and product feeds

What the phrases mean

Phrases left out

Sources