---
title: >-
  Promoted Placements beta now includes Shop Campaigns - Shopify developer
  changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/promoted-placements-beta-now-includes-shop-campaigns
  md: >-
    https://shopify.dev/changelog/posts/promoted-placements-beta-now-includes-shop-campaigns.md
metadata:
  effectiveApiVersion: ''
  affectedApi: []
  primaryTag:
    displayName: Catalog
    handle: catalog
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2026-10-27T02:14:58-04:00'
  postedAt: '2026-10-27T09:00:00-04:00'
  updatedAt: '2026-10-27T07:36:48-04:00'
  effectiveAt: '2026-10-27T09:00:00-04:00'
---

October 27, 2026

# Promoted Placements beta now includes Shop Campaigns

DateOctober 27, 2026

FlagsUpdate

SurfacesCatalog

Promoted Placements is now in beta, and it includes Shop Campaigns. When a `search_catalog` result comes from a merchant running Shop Campaigns, you earn the commission that merchant funds, added to Shopify's base rate. No action is required.

## 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](https://shopify.dev/docs/agents/catalog/promoted-placement) 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 to do

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.

## Related docs

* [Catalog API](https://shopify.dev/docs/agents/catalog)