CPANEL TUTORIALS & GUIDES

Creating Apache Handlers in cPanel

cPanel Apache Handlers controls how the web server processes specific file types and extensions. Add or remove custom handler mappings to run specialized scripts, interpret dynamic content, or assign server actions to selected files without changing their underlying format.

Updated: June 20, 2026
By: RSH Web Editorial Staff

Hosting from $2.99/mo
  See Plans    Contact Us

Menu

cPanel - Advanced - Apache Handlers

Handlers
Apache handlers determine how the Apache web server processes specific file types and extensions on your website. By default, Apache is set up to handle CGI scripts, and server-parsed files (SSI).. If you want Apache to treat a new file type using an existing handler, you can add it manually below. For instance, to make the server handle files with a .example extension as CGI scripts, enter cgi-script in the Handler field and .example in the Extension(s) field.

Explore RSH Web Services beginners guide to cPanel features. Learn everything you need to set up, manage, and optimize your website and hosting effortlessly

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:

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.

cPanel Tutorials and How-To Articles
Finding your way around your cPanel hosting account

Tweet  Share  Pin  Email

Add Comment

* Required information
Drag & drop images (max 3)

Comments

No comments yet. Be the first!

Crafted by our talented master copywriters

RSH Web Services is a leading web hosting provider with the most reliable, secure and fast service at affordable prices. We serve small businesses, large businesses and everything in-between. Our goal is to bring you the best value for your money with all of our website packages