How to enable detailed error messages in IIS Print

  • Windows, Lucee, ColdFusion
  • 4

Enabling Detailed Error Messages on a Windows Hosting Plan

Detailed error messages are invaluable when it comes to diagnosing and resolving issues within your Windows hosting plan. While many hosting providers offer control panel options to enable detailed errors, you can also manually configure them by editing the 'web.config' file of your website. This method provides more control over error message settings and can be especially useful when control panel options are limited. Here’s a step-by-step guide on how to manually enable detailed error messages by editing the 'web.config' file:

Step 1: Accessing Your Website Files

  1. Use an FTP (File Transfer Protocol) client or the File Manager tool in the hosting control panel to access your website’s files. You’ll need to locate the root directory of your website where the 'web.config' file is stored.

Step 2: Locating the 'web.config' File

  1. In your website’s root directory, find the 'web.config' file. This file holds configuration settings for your website, including error handling.

Step 3: Editing the 'web.config' File

  1. Before making any changes, create a backup of the 'web.config' file on your local computer. This ensures you can revert to the original state if necessary.
  2. Open the 'web.config' file using a text editor such as Notepad or Visual Studio Code.

Step 4: Modifying Error Handling Settings

  1. Locate the <system.web> section within the 'web.config' file. This section contains various settings for your website.
  2. To enable detailed error messages, modify or add the following lines:
    <system.web>
     <!-- Other configuration settings -->
     <customErrors mode="Off" />
    </system.web>
  3. The <customErrors mode="Off" /> line turns off custom error messages, allowing detailed error messages to be displayed.

Step 5: Adding HTTP Errors Configuration

  1. While still in the 'web.config' file, locate the <system.webServer> section. If it doesn’t exist, you can create it.
  2. Add or modify the following lines within the <system.webServer> section:
    <system.webServer>
     <!-- Other configuration settings -->
     <httpErrors errorMode="Detailed" />
    </system.webServer>

    The <httpErrors errorMode="Detailed" /> line configures the server to display detailed error messages for HTTP errors.

Step 6: Saving and Uploading Changes

  1. After making the necessary changes, save the 'web.config' file.
  2. Upload the modified 'web.config' file back to the root directory of your website, replacing the original file.

Step 7: Testing Error Messages

  1. To confirm that detailed error messages are now enabled, trigger an error on your website (e.g., accessing a non-existent page).
  2. Instead of generic error messages, you should see detailed error information, including error codes, file paths, and potentially stack traces.

Step 8: Reverting Changes (Optional)

  1. If you’ve resolved the issues and no longer need detailed error messages, you can revert the changes.
  2. Open the 'web.config' file, and either remove or comment out the lines added in Steps 4 and 5.
  3. Save the file and upload it to your website’s root directory.

By manually editing the 'web.config' file to enable detailed error messages, you gain more control over error message settings on your Windows hosting plan. This method is particularly useful when you want to enable detailed error messages without relying on a control panel interface. However, keep in mind that editing configuration files carries some risk, so be cautious and create backups before making changes. If you’re unsure about any steps, consider consulting with technical support or seeking assistance from experienced web developers.


Was this answer helpful?

« Back