Two of cPanel’s more advanced tools — Apache Handlers and MIME Types — control how your server processes and delivers different kinds of files. Most people never need to touch them, but when you do, understanding what they do saves a lot of confusion. Here’s a plain-language guide.
MIME Types: telling browsers what a file is
A MIME type is a label that tells a browser what kind of file it’s receiving — an image, a PDF, a video, a web font — so the browser knows how to handle it. Your server already knows the common ones. You’d only add a MIME type when serving an unusual file format that the browser is mishandling — for example, downloading a file instead of displaying it, or vice versa.
Adding a MIME type
- In cPanel, open MIME Types under the Advanced section.
- Enter the MIME type (the format label) and the file extension it applies to.
- Save.
A common real-world use is adding the correct type for a web font so browsers load it properly, or for a specific media format your site uses.
Apache Handlers: controlling how files are processed
Apache Handlers tell the server how to process files with a given extension before serving them. The classic example is making the server treat files with a custom extension as PHP, so they get executed rather than shown as plain text. Again, this is a specialist need — the standard extensions are already handled correctly.
Adding a handler
- Open Apache Handlers under the Advanced section.
- Enter the handler and the extension it should apply to.
- Save.
When you’d actually use these
Honestly, most site owners never open these tools. They come into play for specific situations: a custom application that uses unusual file extensions, a legacy setup that needs a particular file type executed a certain way, or a browser stubbornly mishandling a file format your site serves. If a piece of software’s documentation tells you to add a handler or MIME type, that’s your cue.
A word of caution
Because these tools change how the server treats files, a wrong entry can cause files to be served or processed incorrectly — for instance, making the browser download pages instead of displaying them. Only add entries you understand or that specific documentation instructs, and test afterwards to confirm the affected files behave as expected.
The safer path for most needs
Before reaching for Apache Handlers, check whether your goal can be achieved more simply — through your application’s own settings, or a straightforward .htaccess rule. These handler tools are the right answer for genuine edge cases, but they’re rarely the only way to solve a problem.
If you’ve been told to add a handler or MIME type and you’re not sure it’s right, send us the instructions. We’ll confirm whether it’s needed and set it up correctly, so you don’t risk affecting how your site is served.
