Troubleshooting

Issues can always arise. With our paid plans, support is included. But this only works out for us both, if sufficient basics are covered first. This page and subpages include handy information when troubleshooting things yourself.

Keeping your modules up-to-date

We update our extensions very frequently. With that, if there is a bug, the first thing we will often ask you to do is to upgrade. Every module is released with a CHANGELOG.md that you can review beforehand to check if the fix you need is included.

If you are not keeping your modules up-to-date, the first thing we need to know is which module versions you are using. You can install the LokiCheckout_CoreAdminhtml module to allow for showing a list of modules in your Magento instance and whether a new version is available or not.

Also, on our site, you can always retrieve the latest module information. You can cross-match this with the modules you have installed. From the CLI, analysing your composer.lock becomes easier if you are using the tool jq:

cat composer.lock | jq '.packages[] | "\(.name),\(.version)"' -r

Run the system check

The LokiCheckout_CoreAdminhtml module also offers a System Check page in the Magento Admin Panel with common configuration issues. Review it to make sure all checks are green.

Duplicating the issue

When an issue arises in production, the worst thing you can do is try to troubleshoot and fix it in production - other things might easily break as well. Instead, make sure a testing environment is an exact duplicate of the production environment and reproduce the issue there.

We never fix an issue directly on production. You are in control of deployment, so the analysis and fix should be done in another environment first.

One of the first things to check - when dealing with an issue within the Loki Checkout - is to see if the same problem arises with the Luma Checkout. Disable the Loki Checkout via its setting Loki > Loki Checkout > General > Enable = No (loki_checkout/general/enable is 0). When using Hyva, enable the Hyva Theme Fallback to use the Luma checkout. If the problem occurs in both the Loki Checkout and the Luma Checkout, the problem is out of scope for the Loki Checkout.

In this section

Last modified: November 17, 2025