Developers can enable detailed CFML error information to identify specific lines of code or configuration issues during the development or troubleshooting of a ColdFusion or Lucee application. This process allows the system to display descriptive error messages instead of generic "Internal Server Error" pages.
Important: Detailed error information should only be enabled temporarily during active development or troubleshooting. Leaving this setting enabled on a production site can expose sensitive system information and internal code paths to the public.
Before you begin
You will need:
Developer access to the ColdFusion or Lucee Administrator.
Access to the server's web management interface (such as Windows Control Panel or a direct web URL).
Enabling detailed error information
Open the ColdFusion or Lucee Administrator.
Navigate to Debug Settings (or Debugging in some versions).
Locate the Debug Output or Debug Logging section.
Set the Debug Output (or Debug Logging) option to Full or Detailed.
Select Save or Apply.
Disabling detailed error information
Once you have identified the issue, you must disable the detailed output to secure the production environment.
Open the ColdFusion or Lucee Administrator.
Navigate to Debug Settings.
Set the Debug Output (or Debug Logging) option back to Off or None.
Select Save or Apply.
Confirm the result
When a script error occurs, the application should display a detailed error page including the file name, line number, and the specific CFML error.
After you disable the setting, the application should return to showing standard, non-detailed error pages for the public.
If the error page does not change
If the error page remains generic after you have enabled "Detailed" output, the issue may be caused by a secondary layer of error handling.
Check for
cfsetorcfdump: Ensure your code is not catching exceptions and displaying a custom, simplified error message.Check for
cfabort: Ensure the script is not being terminated by acfabortcommand before the system can display the detailed error.Check for Web Server Overrides: If you are using IIS or Apache, the web server may be intercepting the error before ColdFusion can display the detailed page. Check the web server's error page settings.
Limitations
This procedure only affects the internal ColdFusion or Lucee engine's reporting. It does not override custom error pages defined in your application's code or by the web server's configuration.
