Creating Apache Handlers in cPanel

cPanel tutorials & how to guides
Regular updates, maintenance improvements and security measures

Configure Apache to handle new file types

Updated: January 19, 2023
By: RSH Web Editorial Staff

Contact Us

cPanel Version 108.0.15  -  Theme Version Jupiter

cPanel Tutorials Apache Handlers

cPanel - Advanced - Apache Handlers

Apache handlers control how the Apache web server software manages certain file types and extensions for your site. Apache comes configured to handle HTML and SHTML files , CGI scripts and server-parsed files (SSI)..

Apache Handlers

Create an Apache Handler

Login to your cPanel and access the option "Apache Handlers".

You can configure Apache to handle a new file type with an existing handler by manually adding the handler and extension.

Apache can handle CGI scripts and server-parsed files. The file extensions for these files include .cgi, .pl, .plx, .ppl, .perl, and .shtml.

To add an Apache handler, perform the following steps:

Enter the handler name in the Handler text box. This can be any name you choose
cPanel includes the following built-in handlers:

  • default-handler - Sends the file and uses Apache’s default handler for static content
  • send-as-is - Sends the file with HTTP headers intact
  • cgi-script - Handles the file as a CGI script
  • imap-file - Parses the file as an imagemap rule file
  • server-info - Retrieves the server’s configuration information
  • server-parsed - Parses the file for server-side includes
  • server-status - Retrieves the server’s status report
  • type-map - Parses the file as a type map file

Enter the file extension in the Extension(s) text box.

Space-separate multiple extensions (for example, .cgi .pl .ppl).

Click Add.

For more information, read Apache’s documentation.

Note: This interface does not allow you to create custom Apache handlers.

Remove an Apache Handler

To remove a user-defined handler, perform the following steps:

Click Delete under the Remove heading for the appropriate handler in the User Defined Apache Handlers table.

Click Yes.

Note: You cannot remove the file extensions that Apache automatically handles.

Related cPanel Tutorials and How To Guides
Over 75 different website hosting features available

Tweet  Share  Pin  Email

We welcome your comments, questions, corrections and additional information relating to this article. Please be aware that off-topic comments will be deleted.
If you need specific help with your account, feel free to contact us anytime
Thank you

More Articles Of Interest

RSH Web Services is a web hosting company that provides a solution to all your web hosting requirements with 99% uptime, guaranteed support and providing you with the best possible website hosting services at an affordable price