Page tree
Skip to end of metadata
Go to start of metadata

This document is for a previous release of cPanel & WHM. To view our latest documentation, visit our Home page.

For cPanel & WHM 11.46

(Home >> Advanced >> Apache Handlers)


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, 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 to the Apache Handlers interface. For example, to instruct the server to treat files with the extension .example as CGI files, enter cgi-script under Handler and .example under Extension(s).

Add 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.
    • You may enter more than one extension at a time. 
    • Separate each entry with a space. 
    • A file extension consists of the letters after the dot (.) in a file name. For example, filename.fileextension.
  3. Click Add.


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

Remove a Handler

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

  1. Click the X button under the Remove heading for the appropriate handler in the User-Defined Apache Handlers table.
  2. Click Yes to confirm that you wish to remove the handler.


 You cannot remove the file extensions that Apache automatically handles from the System Apache Handlers table.