Troubleshoot Elements
Buy with Prime API is now available for early access
Sign up for early access to the Buy with Prime API using the 'Sign Up' button below. The API may change as Amazon receives feedback and iterates on it.
Use the following information to diagnose and fix common issues with Buy with Prime elements on your site.
No elements displaying on product pages
If the delivery message or delivery card element doesn't render for any product on the page, the issue is likely with the element installation itself. To resolve this issue, do the following:
- Verify that the element script is correctly installed on the page. For more information, see Add an element to your site.
- Confirm that you're using the correct Business Product ID in the element configuration.
- Check the browser console for script errors or failed network requests that indicate a misconfiguration.
Element works for some products but not others
If the delivery message or delivery card element renders correctly for some products but not others, the issue is at the product level. Common causes include the following:
- Product not enabled for Buy with Prime: The element only renders for products that you activate for Buy with Prime. Verify that all intended products show as active in the Buy with Prime merchant console.
- Wrong product identifier used: Make sure you use the correct identifier attribute in the element tag. For details about each identifier, see Product identifier reference.
- Duplicate SKUs: If your catalog has duplicate SKUs, you can't reliably use the SKU as a unique identifier. In this case, use
product-idorproduct-external-idinstead.
Product identifier reference
Elements support the following product identifiers:
product-external-id: An identifier from your ecommerce platform.product-id: A Buy with Prime generated product ID.product-sku: A SKU from your ecommerce platform.product-marketplace-id: A marketplace-specific product identifier.product-amazon-sku: Amazon SKU on Amazon Seller Central or Supply Chain Portal.
Updated 2 days ago
