How To Create Custom File Extensions With .htaccess

Board of the .html, .php, etc file extensions? Don’t want to remove them (You can find instructions on how to do so here if you want to remove them), but want to replace them with something more interesting? This guide will show you how to replace the extensions with anything, without changing its functionality (Hopefully).

The code

All you have to do is add the code below into your .htaccess file and save it! Like all file changes, it can take some time before it updates everywhere, but you can speed up the process on your devices simply by clearing your browser’s cache. This code snippet will allow you to change the file extensions on your website to whatever you want.

RewriteEngine on
RewriteRule ^(.*)\.CUSTOM$ $1.php

IMPORTANT! The "RewriteEngine on" line should only be found ONCE in your entire .htaccess file. If it is needed, is should be located before any other statements (At the top of the file).

Note: An .htaccess file located in a sub-directory overrides any duplicate rules from previous .htaccess files. For example, if you have a .htaccess file located in the root defining a 404 and 403 error page, and another .htaccess located in the “test” folder defining only a 404 error page, any files and folders in the “test” folder will use the 404 page defined in the "test" .htaccess file, and the 403 page defined in the root .htaccess file.


Unsure of how to install this code? It's pretty simple. A .htaccess file is called “.htaccess”, with nothing before the dot. Try finding this on your FTP software. Many systems don’t allow filenames starting with a dot (So downloading a htaccess file can be difficult at times), so that also restricts how we can create a .htaccess file. It is possible to get around these restrictions though, so here are the steps!

  1. Open your text-editing program and code your .htaccess file
  2. Once you are finished, save it as “htaccess.txt” (We will fix its name later)
  3. Upload “htaccess.txt” to your webserver and rename it to “.htaccess” (Remember that the dot is important!)

If you are still confused, or it's not working for you, check out the more detailed instruction in our Finding, Creating, and Editing a .htaccess file article.


Hopefully you were successful in installing this snippet, if you need help, feel free to send us a message! Check out the rest of the htaccess snippets to see what other amazing things you can do!


Article Author

Related Articles

Finding, Creating, and Editing .htaccess files

.htaccess is amazing! If you haven’t read the <a href="/webhosting/htaccess/what-is-htaccess">introduction to .htaccess</a>, check that out first (Unless you already know the amazing things .htaccess c...


All code and content © 2024. Contact Us to learn more.