Troubleshooting
Blank screens, errors, updates and tracking down the cause of a problem
- Check your store's health with status and check Start any investigation with these two commands, run from the root of your Grav site: status fits on one screen. It shows: the database engine,.
- Admin screens are blank or show 404 errors after an update After you update KahunaCart, an add-on or a payment provider plugin, KahunaCart's admin screens can load blank, or their requests fail with 404 errors.
- How do I find the error behind a problem? Every error KahunaCart hits ends up in logs/grav.log, in the root of your Grav site.
- "Column not found" or "no such table" after an update Some releases add database tables or columns. An error about a missing column or table means those changes have not been applied yet.
- Storefront looks wrong after an update When a fix from a release does not show up, or a storefront page renders oddly after an update, the usual reason is a template override: a copy of a KahunaCart…
- "Out of stock" on a product I have in stock When a customer goes to a payment provider to pay, KahunaCart reserves the stock in their cart with a stock hold, so nobody else can buy the same units while…
- Customers see "The file is temporarily unavailable" This message means the customer's download link is valid, but the store cannot read the file behind it. Check the log.
- A customer's receipt or pay link has expired Links to orders in emails are signed and expire. There are two different messages, with different fixes. The signed link to a receipt or invoice has run out.
Still stuck?
Tell us what's going on and we'll help. We'll see what you searched for, so you won't have to repeat it.