Resolving duplicate items
Market availability: US only
When identical products appear under different identifiers (for example, GTIN, UPC, or WPID), they’re treated as duplicates. After you review the item details, choose one of two paths:
- Confirm duplicates and merge your offer into the existing catalog item.
- Contest duplicates if you believe the items are unique.
How it works (decision flow)
- Review duplicates identified in your catalog (you can use GET All items API with
showDuplicateItemInfo=true). - If they are duplicates, submit a Bulk Item Setup feed with feed type
SPLIT_MERGEto confirm the items are duplicates so your offer merges into the correct catalog item. - If the items are not duplicates, use the Dispute submission API to contest the decision.
- Check the dispute status using the Dispute status API.
Track outcomes:
- For merges, monitor your feed processing result.
- For contests, poll the duplicate Dispute status API endpoint until items reach the COMPLETED status.
Updated about 3 hours ago
Did this page help you?

