Skip to main content
Apache Handlers is a niche tool for telling Apache to process files of a given extension with a specific handler module. The form writes an AddHandler line to your .htaccess.
Apache Handlers form with handler and extension fields

cPanel home → Advanced → Apache Handlers

What it does

By default, Apache and LiteSpeed know how to handle every common file type: .html, .php, .css, .js, images. This tool exists for the rare case where you need an unusual extension treated as a known handler. A made-up example: you want .tpl files to be parsed as PHP. You’d add a handler with Handler: application/x-httpd-php and Extension: tpl. In practice, almost no modern stack needs this. Frameworks include their own routing.

Add a handler

1

Type the handler name

Common values: application/x-httpd-php (parse as PHP), cgi-script (run as CGI), server-parsed (parse Server-Side Includes).
2

Type the extensions

Space-separated, no dot. Example: tpl tmpl.
3

Click Add Handler

cPanel writes an AddHandler line to ~/public_html/.htaccess. Effect is immediate.

Common questions

Either the .htaccess line was overridden by something deeper in the directory tree, or the handler name is wrong. Open ~/public_html/.htaccess directly and check the AddHandler line is there. Test with a simple file (e.g., test.tpl containing <?php phpinfo(); ?>).
Honestly, almost never. The case we still see occasionally: legacy applications shipping templates with unusual extensions that need PHP parsing. If you’re on a modern stack (WordPress, Laravel, Drupal, Magento), you don’t need this. If you’re not sure whether you need it, you don’t.

Need a hand?

Open a ticket

Best for anything that needs an account check or a config change on our end.

Live chat

Faster for quick questions during business hours.