Promoted Placements beta now includes Shop Campaigns
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on October 27, 2026.
This Shopify update is categorized as Catalog, Update.
What changed
Merchants running Shop Campaigns with external platforms turned on now include the Catalog API as one of those platforms. On their products, placement.commission.percentage.value returns the total rate, combining the merchant's commission and Shopify's base rate. Buyers who click a product with merchant-funded commission land in Shop (shop.com).
Who is affected
Organizations in the Promoted Placements beta that have accepted the terms and turned on Earn commission for a saved catalog. Access is invite-led, and you can join the waitlist from the docs.
What action may be needed
No action is required, because commission comes back in the same field you already read. Keep passing your enrolled catalog.catalog_id on search_catalog and send buyers to the variant URL exactly as Shopify returns it. If you show a commission rate in your own reporting, read it from placement.commission.percentage.value, since it now varies by product. Earning applies to search_catalog only, and only to products from Shopify merchants.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →