Buy with Prime troubleshooting tool
The Buy with Prime troubleshooting tool is available through the Shopify admin and checks to ensure that the Buy with Prime button is visible and functional on your store. The Buy with Prime troubleshooting tool provides:
- Account and store level checks
- Product level checks
Resolve Buy with Prime button issues
If the Buy with Prime button isn’t loading on your ecommerce site, use the following steps to troubleshoot:
- Open the Shopify admin.
- On the side menu, choose Apps, and then Buy with Prime.
- Choose Troubleshoot your experience.
Choose Select products.
Choose up to 10 Shopify products that are activated for Buy with Prime but the button isn’t appearing in your product detail page.
The troubleshooting tool lists potential reasons for the Buy with Prime button issues. For more information on how to solve button issues, see Account and store level checks and Product level checks.
Account and store level checks
The Buy with Prime troubleshooting tool provides the following checks for account and store level issues:
Check | Description | Solution |
Amazon Multi-Channel Fulfillment settings | The Amazon Multi-Channel Fulfillment (MCF) settings check ensures that your Amazon MCF app settings are correctly configured. | If you detect an issue, follow these steps: 1. Review and update your MCF settings in your Seller Central or Amazon Supply Chain Portal. 2. Ensure your account is activated for inventory sharing with multiple locations. For more information, go to MCF App for Shopify User Guide. |
Seller Central account | The Seller Central account check verifies that your Seller Central account is in good standing. | If you detect an issue, go to Seller Central to solve issues directly. |
Buy with Prime setup | The Buy with Prime setup check ensures that Buy with Prime is correctly configured. | To resolve issues, go to Set up Buy with Prime and Troubleshoot Buy with Prime. |
Third-party logistics app compatibility | The third-party logistics app compatibility check ensures that your existing third-party logistics app supports adding Buy with Prime as an additional fulfillment service. | If you detect this issue, your current third-party logistics app isn’t configured to support multi-managed inventory, which is required to add Buy with Prime as an additional fulfillment service. To solve this issue: • Read through your third-party logistics app help articles or documentation to understand how to activate multi-managed inventory, OR • Reach out to your third-party logistics app provider and ask them to set the parameter permits_sku_sharing to true, as described in |
Note: If the Buy with Prime button isn’t appearing after completing all the necessary checks and resolving any detected issues, contact Merchant Support for further assistance.
Product level checks
The Buy with Prime troubleshooting tool provides the following checks for product level issues:
Check | Description | Solution |
Shopify SKU matched to Amazon | This check verifies that your Shopify product SKUs match your corresponding Amazon SKUs. | Update your SKUs to ensure a match in your Shopify admin account. |
Amazon SKU valid | This check verifies your Amazon SKUs are valid and exist in your Seller Central account. | To review your SKUs: 1. Open the Shopify admin. 2. Navigate to the Buy with Prime app for Shopify home page, and then Settings. 3. Review and correct your SKUs that aren’t valid in your product listings in Buy with Prime app for Shopify settings in your Shopify admin account. |
Amazon SKU buyable | This check verifies if your Amazon SKUs are active and eligible to be sold in your Amazon account. | If they aren’t eligible to be sold, check the status of your item in Seller Central, such as inventory or if the listing is active. |
Offer Prime box checked | This check ensures that Offer Prime is selected for your products. | To activate Offer Prime: 1. Open the Shopify admin. 2. Navigate to the Buy with Prime app for Shopify home page, and then Product mapping. 3. Choose Offer Prime. |
Sufficient inventory for Amazon Fulfillment Services | This check confirms that there’s enough inventory available for Amazon Fulfillment services. Note: if you don’t have inventory, the button won’t appear. | Navigate to Seller Central to restock or manage your inventory in Amazon Fulfillment services. |
Product detail page template compatible | This check ensures that your product detail page template is compatible with Buy with Prime. | If your product detail page template isn’t compatible, see Troubleshoot templates for steps to adjust your template. |
Shopify inventory tracking | This check verifies that inventory tracking is accurately set up in your Shopify store. | Inventory tracking activates when the Buy with Prime app for Shopify is installed, however see inventory tracking to adjust your inventory tracking settings. |
Catalog synchronized | This check confirms your catalog is synchronized between Shopify and Buy with Prime. | Perform the following steps: 1. Open the Shopify admin. 2. Navigate to the Buy with Prime app for Shopify home page, and then Product listings. 3. Deselect and re-select Offer Prime. |
Note: If the Buy with Prime button isn’t appearing after completing all the necessary checks and resolving any detected issues, contact Merchant Support for further assistance.
Error messages
Use the following troubleshooting information to identify and address some issues that can occur while using Buy with Prime app for Shopify.
Error | Cause | Solution |
Service break | There’s a service break or a problem with the Buy with Prime configuration. | Contact Merchant Support. |
Error occurred when trying to activate Buy with Prime | This message appears when you activate Buy with Prime for a product but the setup process isn’t complete. | Perform the following steps: 1. Confirm that you have an active account for Buy with Prime. This can include your Seller Central or Multi-Channel Fulfillment accounts. To set up your accounts, go to Requirements for the Buy with Prime app for Shopify. 2. Complete the Buy with Prime setup process. To validate the completion of the process, go to Add Buy with Prime to your site on the Buy with Prime app for Shopify. 3. Turn on Offer Prime for the products that you want to activate Buy with Prime for. To map your products, go to Map your products. 4. Validate that there’s available inventory in Amazon fulfillment centers for the selected products. 5. Validate that your Buy with Prime product SKU matches the SKU on your site. 6. Ensure that you have completed the Conditions to offer Buy with Prime. |
Error found in CSV file, changes not saved, or file can’t be processed due to system issues | One of more of your Shopify or Amazon SKUs aren’t valid, are already mapped to another store, or if there’s a server issue. Additionally, the file you uploaded might not be saved using the correct format. | Follow the instructions on Import mappings by CSV to download the correct CSV file template and try again. |
The column headers in this CSV file don’t match with the downloaded template | The template has too many/few columns or the column names are different from the template. | Perform the following steps: 1. Choose Bulk Upload to redownload the template. 2. Match the column headers with the template. 3. Reupload the CSV file. |
CSV files are limited to 15,000 line items or 50mb | The template has too many rows. | Perform the following steps: 1. Choose a smaller CSV file or a CSV file with fewer line items. 2. Reupload the CSV file. |
The CSV file is empty | The CSV file is empty. | Perform the following steps: 1. Choose Bulk Upload to redownload the template. 2. Update the values in the file. 3. Reupload the CSV file. |
The CSV file didn’t include any valid items | The CSV file includes items that aren’t valid. This error might occur because: • Shopify SKUs are blank • Amazon SKUs are blank but Offer Prime is turned on or off. • Offer Prime is turned on or off. | Perform the following steps: 1. Verify your Shopify SKUs match with your Shopify catalog. 2. Verify your Amazon SKUs are filled before offering Prime. |
CSV file partially processed. X products updated, Y products with errors. If SKUs are blank, the matches didn’t update | The CSV file has partial upload success. | Perform the following steps: 1. Download your CSV file and review the error status for each SKU. 2. Correct the errors in the file. 3. Reupload the CSV file. |
Subscribe and Save
The Buy with Prime button should only appear on One-Time-Purchase options on your product details page. If the Buy with Prime button mistakenly appears on a Subscribe and Save option, follow these steps to correct the situation:
1. Place <div class="delivery-promise__promise-container"></div> next to the native Add to cart button to control positioning and customizations of the Buy with Prime buy now button.
2. Wrap <div class="delivery-promise__promise-container"></div> in another encapsulating div: <div class="bwp-buy-now-toggle-container” style="display: none;"></div>. This initializes the buy now button as hidden on the first page load and is used to unhide/hide the button based shoppers’ selections.
3. Monitor for radio button changes from the shopper actions and execute the function to unhide/hide the buy now button. Use the following sample code as reference. Point bwpTargetNode to the <body> element class name, adjust radioElementClassName and oneTimeRadioElementValue variables to match your PDP elements.
Note: Your code may look different based on your ecommerce provider and theme.
Note: To enhance performance, you can also limit the number of times that radioCheck is called by taking any of these two actions:
- Point bwpTargetNode to the smaller block containing buy buttons and one time/SNS selectors
- Observe less number of changing elements
<!-- Start Hide BwP for subscriptions -->
<script defer>
function radioCheck() {
let radioElementClassName = "yotpo-radio-label-input";
let oneTimeRadioElementValue = "One time purchase (full price)";
try {
if (document.getElementsByClassName(radioElementClassName)[0].getAttribute("onchange") == null) {
document.getElementsByClassName(radioElementClassName)[0].setAttribute("onchange", "radioCheck()");
document.getElementsByClassName(radioElementClassName)[1].setAttribute("onchange", "radioCheck()");
if (document.getElementsByClassName(radioElementClassName)[1].value === oneTimeRadioElementValue) {
onetimeIndex = 1;
}
}
if (document.getElementsByClassName(radioElementClassName)[onetimeIndex].checked &&
document.getElementsByClassName(radioElementClassName)[onetimeIndex].getAttribute("data-selling-plan-name") == oneTimeRadioElementValue) {
document.querySelector(".bwp-buy-now-toggle-container")?.removeAttribute("style");
} else {
document.querySelector(".bwp-buy-now-toggle-container")?.removeAttribute("style");
document.querySelector(".bwp-buy-now-toggle-container")?.setAttribute("style", "display: none;");
}
} catch (TypeError) {};
}
var onetimeIndex = 0;
// Point the query selector to the <body>'s class name
const bwpTargetNode = document.querySelector(".template-product");
// What to observe
const bwpConfig = { subtree: true, childList: true };
// Execute mutations
const bwpCallback = (mutationList, observer) => {
for (const mutation of mutationList) {
if (mutation.type === "childList") {
radioCheck();
}
}
};
// Create an observer variable
const bwpObserver = new MutationObserver(bwpCallback);
// Start observing the target node
bwpObserver.observe(bwpTargetNode, bwpConfig);
radioCheck();
</script>
<!-- End Hide BwP for subscriptions -->