Advanced: Apache Handlers

The following information assumes you are logged into cpanel.
To do this, either log into the client area here, or log into cpanel directly.
Full details on logging in is covered in this article:



Apache handlers control how your site’s Apache web server software manages certain file types and file extensions. Apache can handle CGI scripts and server-parsed files. The file extensions for these files include .cgi, .pl, .plx, .ppl, .perl, and .shtml.

You can configure Apache to use an existing handler to handle a new file type. To do this, manually add the handler and extension in this interface.


Creating An Apache Handler

Navigating cPanel

Choose "tools" from the left-hand menu.
scroll down to the "advanced" box and click the "apache handlers" icon
start typing "apache" into the top-right search box, and choose "Apache Handlers" from the drop-down options.

Apache Handlers


Create an Apache Handler

To add an Apache handler, perform the following steps:

  1. Enter the handler name in the Handler text box. 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.
  2. Enter the file extension in the Extension(s) text box.
    • A file extension consists of the letters after the dot (.) in a file name (for example, filename.fileextension).
    • Space-separate multiple extensions (for example, .cgi .pl .ppl).
  3. Click Add.

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:

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

You cannot remove the file extensions that Apache automatically handles.

Was this answer helpful? 53 Users Found This Useful (112 Votes)

Powered by WHMCompleteSolution