Recommended settings

We recommend you configure Magento with the following settings:

Change the number of street lines

The number of street lines is by default 2. However, within a lot of countries the street lines each have their own purpose: Street, house number, house number addition. Because of this (and the workings of LokiCheckout extensions) we strongly recommend you to change the number street lines to 3.

magerun2 config:set customer/address/street_lines 3

Configuration of the number of streetlines
Configuration of the number of streetlines

Disabling additional customer fields

Less is more. The more fields a customer needs to fill in, the less likely the checkout will be completed. We recommend you to get rid of a couple of fields, if they are not relevant:

  • Do not show the middle name (customer/address/middlename_show);
  • Do not show the name suffix (customer/address/suffix_show);
  • Do not show the date of birth (customer/address/dob_show);
  • Do not show the fax number (customer/address/fax_show);
  • Perhaps disable the telephone input as well (customer/address/telephone_show) or at least make it optional;

That being said, the LokiCheckout is compatible with all of these settings.

Configuration of various customer address fields
Configuration of various customer address fields

LokiComponents-specific settings

LokiCheckout-specific settings

Pick Grid Layout @todo

Pick a theme @todo

Pick extensions @todo

Disable CSP or not?

At this moment, CSP is fully supported by the Loki Checkout. All inline JavaScript of all LokiCheckout extensions supports the CSP policies of removing unsafe-eval and unsafe-inline. However, because Loki Checkout is just an extension within a theme based on Hyvä and/or Luma, the real question is whether they support unsafe-eval and unsafe-inline properly.

If you want, you can enable the Yireo_LokiCheckoutCsp module which replaces the normal Hyvä version of AlpineJS with the CSP build of AlpineJS.

Alternatively, you can also disable CSP by enabling CSP reporting:

magerun2 config:store:set csp/mode/storefront_checkout_index_index/report_only 1
Last modified: April 30, 2025