White screen
Common situations:
- click a Mirakl module tab → white screen;
- after install, click Configure → white screen;
- PrestaShop back office cut off (page stops mid-way).
Usually a PHP error is hidden. Turn it on so you can fix it or send it to support.
Step 1 — Enable debug mode (temporarily)
From the back office (if you can still access it):
Advanced Parameters → Performance → Debug mode → Yes → Save.
Via FTP if the back office is unreachable:
In config/defines.inc.php, set:
define('_PS_MODE_DEV_', true);(if config/defines_custom.inc.php exists and already defines _PS_MODE_DEV_, edit that file instead.)
PrestaShop guide (500 error / debug): Error 500 on PrestaShop, follow the guide.
Note: Debug mode can show errors on the storefront too. Turn it off as soon as you have the message. Put the shop in maintenance if needed.
Step 2 — Reproduce the error
- Reload the page / Mirakl tab that failed.
- Copy the full error message (screenshot or text).
Step 3 — Quick checks
Often related to:
- Write permissions issue
- Information tab — common errors (PHP memory / time)
- AJAX script execution failed / server-side error
- conflict with another module / override
Step 4 — Contact support
Send to Contact:
- the error message (screenshot);
- module version + PrestaShop version;
- screenshot of the Information tab — common errors screen if you can open it.
Then disable debug mode (_PS_MODE_DEV_ = false / Debug mode = No).
See also
Get your Mirakl API keys (module Debug Mode), Home
Updated on: 15/10/2026
Thank you!
