Blank page
1 min read
A blank or white page usually means the application or server encountered an error before it could produce a normal response. Because the visible page often contains no useful detail, the goal is to narrow down where the failure occurs and collect safe diagnostic information.
First identify the scope of the problem #
Check whether the blank page affects:
- the entire application
- only one page or feature
- only the administration area
- only public-facing pages
Also note whether the issue started after an installation, update, hosting/server change, customization, or configuration change. That timing can help narrow the cause.
Common causes of a blank page #
Possible causes include:
- an application or PHP error
- missing or incompletely uploaded files
- an incomplete archive extraction
- an incompatible server environment
- a required PHP extension or server capability that is unavailable
- a file permission or ownership problem
- a database connection failure
- an application configuration problem
- an error introduced by a recent update or customization
A blank page does not identify which of these is responsible, so avoid making multiple unrelated changes at once.
Safe troubleshooting steps #
- Review the System Requirements and installation documentation for the specific DotwebApps product.
- Confirm that all application files were uploaded and extracted completely.
- Check whether the problem began immediately after a recent known change.
- Review relevant application or server error logs where available.
- If the product uses a database, confirm that the application can still connect to it.
- Verify file permissions and ownership according to the product documentation and your hosting environment.
- If a recent change is clearly linked to the problem, revert only that known change where it is safe to do so and an appropriate backup exists.
Do not enable public production debug output or expose detailed stack traces to site visitors. If detailed error information is needed, collect it privately and remove credentials, tokens, customer data, and other secrets before sharing it with support.
Related checks #
For broader environment and installation guidance, see:
- Server requirements
- PHP and MySQL requirements
- File permissions
- Database configuration
- Common installation problems
If the page is still blank #
Contact DotwebApps support with the product name, the page or action affected, when the issue began, the hosting/server environment, any recent change, the exact sanitized error message if available, and a redacted screenshot where useful.
Never send passwords, database passwords, private keys, API secrets, payment-card details, unrelated customer data, or full source code. See How to get support for the recommended support path.