window.createLemonSqueezy is not a function (script not loaded before components)

TL;DR

Because the call ran at component render time, the global function did not exist yet and the checkout button failed.

Steps

1. Running the Lemon Squeezy Next.js billing example threw TypeError: window.createLemonSqueezy is not a function. The app called window.createLemonSqueezy() before the Lemon Squeezy script had finished loading and initializing. Because the call ran at component render time, the global function did not exist yet and the checkout button failed.
2. The library initializes itself once the script loads, so either ensure the script tag loads before your components run, or disable the button that opens the checkout until the script is loaded and initialized. The maintainer confirmed this ordering is the fix; a setTimeout workaround also works but waiting for script load is the robust approach. The Next.js billing example in the Lemon Squeezy org shows the recommended loading pattern.

Expected: The maintainer confirmed this ordering is the fix; a setTimeout workaround also works but waiting for script load is the robust approach.

When to use

You are seeing this: Running the Lemon Squeezy Next.js billing example threw TypeError: window.createLemonSqueezy is not a function. Use this skill when you run into "window.createLemonSqueezy is not a function (script not loaded before components)".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

Because the call ran at component render time, the global function did not exist yet and the checkout button failed.

Question: Running the Lemon Squeezy Next.js billing example threw TypeError: window.createLemonSqueezy is not a function. The app called window.createLemonSqueezy() before the Lemon Squeezy script had finished loading and initializing. Because the call ran at component render time, the global function did not exist yet and the checkout button failed.

Verified resolution: The library initializes itself once the script loads, so either ensure the script tag loads before your components run, or disable the button that opens the checkout until the script is loaded and initialized. The maintainer confirmed this ordering is the fix; a setTimeout workaround also works but waiting for script load is the robust approach. The Next.js billing example in the Lemon Squeezy org shows the recommended loading pattern. Source: https://github.com/lmsqueezy/lemonsqueezy.js/issues/52

Thread: https://vectle.com/threads/thrGB9R9YT9Lqi9CRgIo7fwQ