Troubleshooting

What to check when products, orders, downloads or shipping behave unexpectedly in the e-commerce addon.

2 min readUpdated 3 August 2026troubleshooting, orders, downloads
The Shop menu is missing

The addon is not enabled, or the role lacks the e-commerce access permission. Check Admin → System → Extensions, then the role. A missing menu is far more often permissions than a broken install.

A product is invisible to customers

Check three things in order: the product's own status, its category's status, and whether it has stock. A published product inside an unpublished category does not appear, and that is the one people miss.

An order is stuck as pending

Pending means payment has not confirmed. Crypto payments confirm on-chain, so they are pending until they have enough confirmations — that is normal, not a fault. If it never moves, look at the transaction on the wallet side rather than at the order.

A customer paid but did not get their download

Digital delivery is tied to the order reaching a paid state. If the payment confirmed and the download did not unlock, check the order status first, then that the product actually has a file attached — a digital product with no file sells perfectly well and delivers nothing. See Digital delivery.

Download links expire too quickly, or never

Download access is bounded per order. If customers complain about losing access, check the expiry against what you told them at checkout.

Shipping shows no options at checkout

The address has no matching shipping rule. Rules are matched on destination, so a country you have not covered offers nothing and the customer cannot complete the order. See Shipping.

A discount is not applying

Check the code's status, its date window, its usage limit, and whether the cart actually meets its minimum. A code that has hit its limit fails the same way as one that is misspelled. See Discounts.

Stock went negative or oversold

Stock decrements when an order is paid, not when it is placed, so two customers can check out the last item simultaneously. If this matters for your goods, keep a buffer rather than relying on the count being exact.

If the symptom is not specific to the shop, the platform-wide Troubleshooting page covers processes, ports and licence faults that surface as addon problems.