> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://doc.common-services.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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:

```php
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](https://www.prestashop.com/blog/en/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

1. Reload the page / Mirakl tab that failed.
2. Copy the full **error message** (screenshot or text).

---

### Step 3 — Quick checks

Often related to:

* [Write permissions issue](https://doc.common-services.com/en/article/write-permissions-issue-1j105bh/)
* [Information tab — common errors](https://doc.common-services.com/en/article/information-tab-common-errors-16w1grk/) (PHP memory / time)
* [AJAX script execution failed / server-side error](https://doc.common-services.com/en/article/ajax-script-execution-failed-server-side-error-1ez840o/)
* conflict with another module / override

---

### Step 4 — Contact support

Send to [Contact](https://doc.common-services.com/en/article/contact-yuxwdc/):

* the error message (screenshot);
* module version + PrestaShop version;
* screenshot of the [Information tab — common errors](https://doc.common-services.com/en/article/information-tab-common-errors-16w1grk/) screen if you can open it.

Then **disable** debug mode (`_PS_MODE_DEV_` = `false` / Debug mode = No).

## See also

[Get your Mirakl API keys](https://doc.common-services.com/en/article/get-your-mirakl-api-keys-1g54d55/) (module **Debug Mode**), [Home](https://doc.common-services.com/en/article/home-1vxkakw/)