PayPal Button Not Working or Not Showing on Your Website
The PayPal button is not working or not showing on your website — the space where it should be is blank, the button appears but does nothing, or the PayPal window opens and then closes with an error.
Common signs of this issue
- The PayPal button is not showing on your checkout, cart, or product page — there is just an empty gap where it used to be.
- The button appears, but clicking it does nothing, or it spins and never opens the PayPal window.
- The PayPal pop-up opens and immediately closes, or shows a message that something went wrong.
- The button works for you but not for some customers, or works on desktop but not on phones.
- Customers can log in to PayPal but get an error when they try to complete the payment.
- It stopped working right after a plugin, theme, or WordPress update, a security change, or a change to your PayPal account.
Safe checks you can do yourself
None of these require sharing passwords with anyone.
- Test in a private or incognito window with browser extensions turned off, then on your phone using mobile data. Ad blockers and privacy extensions sometimes block PayPal's scripts; if the button appears in a clean browser, the problem may be on the visitor's side rather than your site.
- Try a different browser. If one browser shows the button and another does not, strict tracking protection or a browser extension is the likely cause, not your shop.
- Log in to your PayPal business account and look for any notices, limitations, or requests for information. A limited or restricted account can stop payments from completing, and PayPal usually explains what it needs on the account dashboard or by email.
- In your shop or payment plugin's PayPal settings, check whether it is set to sandbox or test mode. Sandbox credentials only work with PayPal's test accounts; real customers need live mode with live credentials. Also confirm the connected account is the one you expect.
- Check your store currency and country settings. PayPal only supports certain currencies, and some features and button types are only offered in some countries. If the store currency is unsupported, the button may be hidden entirely.
- Check whether the PayPal option is limited by product type, cart total, or shipping rules in your plugin settings. Some setups hide the button on certain pages (like the cart or product page) by design.
- If you are comfortable with it, open the browser's developer tools (usually F12), go to the Console tab, reload the page, and look for red errors mentioning PayPal, a blocked script, or a Content Security Policy. Copy the text — it is exactly what a developer will want to see.
- Think about what changed last: a new plugin, a theme update, a caching or script-optimisation setting (such as combining or delaying JavaScript), or a new security plugin. Script optimisation is a very common way to break PayPal buttons without any error on the page.
- Make sure the payment plugin itself is current. PayPal changes its integrations over time, and old or abandoned plugins can stop working. Update on a staging copy first if you can.
What this usually means
Modern PayPal buttons are not plain images — they are drawn by a script loaded from PayPal when the page opens. If that script is blocked, delayed, or broken, the button simply does not appear, and nothing on the page tells the visitor why. The usual blockers are ad blockers and privacy extensions on the visitor's side, and on your side a caching or optimisation plugin that delays or combines scripts, a strict Content Security Policy that does not allow PayPal's domains, or a JavaScript error from another plugin that stops everything after it from running.
When the button appears but the payment fails, the cause is more often configuration or account-related. Sandbox credentials on a live shop, keys from a different PayPal account, an unsupported currency, or a PayPal account under review or limitation will all let a customer click the button and then fail. The exact error messages and settings vary between plugins and PayPal products, so PayPal's own help pages and your plugin's documentation are the final word on specifics.
It is worth knowing which case you are in. A button that is missing points to scripts and page setup; a button that fails after login points to credentials, currency, or the PayPal account. If PayPal works but the order never updates afterward, that is a separate issue — see WooCommerce orders stuck on Pending payment. And if cards fail regardless of method, payments declined at checkout is the better starting point.
What not to do
- Don't paste your PayPal API secret, password, or account details into forums, support chats, or emails.
- Don't switch to sandbox mode on a live shop to test. Real customers cannot pay while it is on.
- Don't install a second PayPal plugin alongside the first. Two integrations on one page often break both.
- Don't disable your whole security or caching setup permanently to make the button appear. Find the specific rule or setting instead.
- Don't ignore emails from PayPal about account limitations. They rarely resolve on their own and can hold your funds.
- Don't assume the button works because it works for you. Test from a clean browser and a phone.
When to get help
If the console shows script errors you cannot trace, if the problem only appears for some customers, or if it started after a plugin or optimisation change and you cannot tell which one, get help. PayPal problems often come down to one setting deep in a caching, security, or theme configuration, and every day the button is broken is a day of lost sales from customers who prefer PayPal. An experienced fixer will reproduce the problem, read the actual error, and adjust the one thing that is blocking it rather than stripping out protections.
Glenn runs WebsiteSelfHelp and fixes broken and missing PayPal buttons for small business shops. Request a direct review with a link to the page and a note of what customers are seeing, and he will tell you plainly what is wrong and what it will take — no logins needed to get started.
Not sure what to do next?
Answer a few short questions and we'll point you to the safest next step — DIY, a freelancer, or a direct review. No passwords required.
Is this a business website? If this issue may be costing you leads, sales, or trust, you may want a direct review instead of trial and error.
Frequently asked questions
Why is my PayPal button not showing on my website?
Usually the PayPal script is being blocked or broken — by an ad blocker, a caching or script-optimisation setting, a security policy, or a JavaScript error from another plugin. An unsupported store currency can also hide it.
Why does the PayPal button do nothing when clicked?
A JavaScript error on the page or a delayed script is the most common cause. Check the browser console for red errors and think about any recent plugin or optimisation changes.
Why does the PayPal window open and then close?
This often points to a credential problem, such as sandbox keys on a live site or keys from a different account, a pop-up blocker, or an issue with the PayPal account itself. The console or PayPal account notices usually give the clue.
Can an ad blocker stop PayPal buttons from working?
Yes. Some ad blockers and privacy tools block PayPal's scripts. If the button works in a clean private window but not in a customer's usual browser, that is the likely reason.
Is a PayPal button problem my fault or PayPal's?
Most of the time it is something in the site setup or account settings rather than a PayPal outage. Check PayPal's status page if it suddenly fails for everyone at once.
Can I fix a PayPal button that is not working myself?
You can check test mode, currency, account notices, and recent changes yourself. Tracing script conflicts or security policy errors is usually faster with someone who does it regularly.