Service eligibility and regional restrictions
PuppyIP serves only compliant overseas businesses and their authorized personnel. Proxy services are not available in mainland China. The service may only be used for lawful business activities outside mainland China. Use of this service within mainland China is prohibited.
Hosting a proxy IP or server overseas does not change these restrictions. The service must not be provided to end users in mainland China through relaying, forwarding, sharing or resale. Before use, read the Terms of Service.
Key Takeaways
- Promoted Placements remains invite-led. An organization must accept the terms and enable Earn commission on a saved catalog.
- placement.commission.percentage.value is one total rate that already includes Shopify's base commission and the merchant-funded Shop Campaigns amount.
- The merchant-funded increase varies by product and applies only to active campaign products in the US, in USD, when the buyer completes the purchase in the Shop app or on shop.com.
- Commission applies only to Shopify merchant products returned by search_catalog. External products have no placement object and earn no Promoted Placements commission.
Which Catalog API integrations are affected?
On October 27, 2026, Shopify announced that Promoted Placements is in beta and that Catalog API search now includes Shop Campaigns merchants with external platforms turned on. For an integration enrolled in the program, eligible search_catalog results can return merchant-funded commission. The update does not require a new endpoint in existing request flows.
This is not automatic revenue for every Shopify app. Shopify's changelog calls the program a beta, while its program documentation describes rates in Developer Preview and warns that rates may change before general availability.
Check program and saved-catalog eligibility first
Promoted Placements is invite-led. An eligible organization must join the program, accept its terms and enable Earn commission on a saved catalog. An app that has not joined, or a catalog without that setting, will not receive the merchant-funded amount. New catalogs and catalogs saved before enrollment may have different defaults, so check each catalog's actual setting in the Dev Dashboard.
Keep passing the enrolled catalog.catalog_id to search_catalog. Shopify uses it to apply the saved catalog's settings; without program access, a response may contain only organic results. A successful API request by itself does not prove that the app can earn promoted-placement commission.
The commission field is the base rate plus the merchant-funded amount
For a promoted product with a placement object, read placement.commission.percentage.value directly. It is the total rate for that product: Shopify's base commission plus the amount funded by the merchant through Shop Campaigns. Do not add the base rate a second time.
Shopify's current Developer Preview documentation lists a 0.3% base rate for eligible products and says rates may change before general availability. A merchant campaign can raise the total rate on a product, so do not apply one product's rate to the whole catalog. Preserve the value returned for each variant.
When does the merchant-funded increase apply?
The Shop Campaigns-funded portion applies only to eligible active-campaign products in the United States, in USD. The buyer must complete the purchase in the Shop mobile app or on shop.com for the rate above the base amount to apply.
If the buyer completes checkout on the merchant's own website or in another checkout experience, the purchase may earn only the base rate if it is eligible. A higher rate in a search result does not by itself guarantee the campaign increase. The program applies its own attribution and qualification rules; cancellations, refunds or invalid traffic can also reverse commission.
Which results do not include this commission field?
The earnings apply only to Shopify merchant products returned by search_catalog. Organic products may have no placement object, and external products are outside the commission program. Do not infer that every result is commission-eligible just because a merchant runs a campaign.
External brand products are a separate kind of Catalog API result: they are sold on the brand's own website, have no Shopify checkout, and earn no Promoted Placements commission. Clearly distinguish the sources when you show both types to shoppers.
How do you preserve purchase attribution?
When sending a buyer to a returned variant URL, preserve its attribution parameters exactly. Do not replace it with a redirect on your own domain, mask the destination or remove parameters; Shopify says those changes can prevent attribution.
For reconciliation, separate the API's product rate, where the purchase happened and the final qualified commission. The base rate, campaign increase and paid-out amount are different facts; do not report a preview value as income already received.
Sources
Frequently Asked Questions
Should I add Shopify's base rate to placement.commission.percentage.value?
No. Shopify says this value is the total rate and already includes the base commission plus any merchant-funded campaign increase.
Does every Shop Campaigns product get the higher commission?
No. The merchant-funded increase requires an eligible active campaign product in the US, in USD, and a completed purchase in the Shop app or on shop.com. The integration must also qualify for Promoted Placements.
Is Promoted Placements open to every Shopify app?
No. Shopify says access is invite-led. The organization must accept the terms and enable Earn commission for the saved catalog.
Can external brand products earn Promoted Placements commission?
No. Shopify's documentation says external products do not include a placement object and are not eligible for the commission program.