Paddle Checkout Not Loading

How to fix it

Try these in order — the most common fix is first.

1. 1. Read the console

   Copy steps
   1. Open DevTools > Console and look for Paddle.js errors
   2. Log checkout.error and checkout.payment.error events
   Did this fix it? Yes No

2. 2. Check token and environment

   Copy steps
   1. Confirm Paddle.Initialize uses the client-side token for the right environment
   2. Sandbox needs Paddle.Environment.set('sandbox')
   Did this fix it? Yes No

3. 3. Confirm the script loads

   Copy steps
   1. Add the Paddle.js script before your init code
   2. Fix 'Paddle is not defined' by loading it on the page
   Did this fix it? Yes No

4. 4. Check domain approval and price IDs

   Copy steps
   1. Live: make sure the domain is approved
   2. Verify price IDs exist in the same environment
   Did this fix it? Yes No

Symptoms

The overlay does not open, prices do not appear, or you get 'Paddle is not defined'.

Why it happens

• Sandbox token (test_) used with live prices or the reverse
• Live domain not approved
• Paddle.js script not loaded before Initialize
• Invalid price ID or empty items
• Page inside an iframe where the source URL is invalid

This guide also covers

• paddle checkout not loading
• paddle overlay checkout blank
• paddle.js error
• paddle checkout not working

The same problem in other apps

All not loading, error messages & connection guides →

• Gumroad Download Link Not Working (Gumroad)

Other Paddle errors

• What Is the Paddle.net Charge on My Card Statement?
• Paddle Refund Request: How to Get Your Money Back
• How to Cancel a Subscription Purchased via Paddle
• Paddle Payout Delayed or Missing
• Paddle Account Verification and Domain Approval Rejected
• Paddle Webhook Not Firing or Signature Failing
• Paddle Account Closed and Funds Held
• Paddle Support Not Responding