Troubleshooting

#The Quick Order page shows a 404 error

• Verify the module is enabled: Stores → Configuration → General → Quick Order → Enable Quick Order = Yes
• Run bin/magento cache:flush after changing settings
• If the problem persists, run bin/magento setup:upgrade

#I can't see the Quick Order link in the navigation

• Check that at least one link placement is enabled in Stores → Configuration → General → Quick Order → Link Placement
• If access restriction is enabled, make sure you are logged in with an authorized account
• Clear the full page cache: System → Cache Management → Flush Magento Cache

#Products are not loading or the grid is empty

• Ensure you have active, visible products in your catalog
• Check that products are assigned to the default website/store
• For server-side mode: verify that the AJAX endpoint is accessible (check browser console for errors)
• Try switching Data Loading Mode to "Client-side" in admin settings for debugging

#Quantities are not being saved between page visits

• Quantities entered in the grid are temporary session data. They are not saved between page visits.
• To preserve product lists between visits, use the Saved Order Templates feature (requires login)

#CSV import is not finding my products

• Verify that the correct identifier type is selected (SKU, EAN, MPN, or Reference)
• Check that the identifiers in your CSV match exactly with the values in your Magento catalog (case-sensitive)
• Make sure the correct separator is selected or use auto-detect
• Verify the "First row is header" checkbox is set correctly

#"Add to Cart" shows errors for some products

• Some products may have gone out of stock since the page was loaded. Refresh the page to get current stock levels.
• Check minimum order quantities — the ordered quantity must meet or exceed the product's minimum.
• The error notification shows which specific products failed and why.

#The barcode scanner doesn't work

• Camera scanner: Ensure your browser has camera permission enabled for your store's domain. Check browser settings if the camera feed doesn't appear.
• Hardware scanner: Make sure the scanner device is in HID (keyboard emulation) mode. The scanner should be plugged in before activating hardware scanner mode.
• Verify that the scanned barcode value matches the EAN or SKU field in your product catalog.

#The grid is slow with many products

• Switch to Server-side data loading mode in admin settings
• Lower the server-side threshold (e.g., from 3,000 to 1,000)
• Hide unnecessary columns (Image, Description) to reduce rendering load