Locked out of my site after applying a .htaccess using Admin Tools' .htaccess Maker

Sometimes, when you apply a .htaccess file on your site, you get a blank page or an Internal Server 500 error message when trying to access your site's front- or back-end.

There are two reasons this might happen.

Some settings may be incompatible with your host

Working around this is simple:

  1. Using your favourite FTP application, e.g. FileZilla or CyberDuck, go to your site's web root

  2. Find the .htaccess file and rename it to htaccess.bak. If you do not see the .htaccess file listed there, create a blank text file on your local machine, rename it to .htaccess and upload it to your site. It will overwrite the existing one.

  3. Log back in to your site's back-end, go to Components, Admin Tools, .htaccess Maker, disable some options and then click on Save and apply .htaccess.

  4. If this produces the same error, repeat this procedure. Do note that different servers support different features of our .htaccess Maker. There is no way to know beforehand. Making the perfect .htaccess for your site is a trial-and-error process.


If you are on GoDaddy, please note that changes on .htaccess files (or removing them completely) take anywhere between 10-30 minutes to become effective.

The PHP version was reset to the server's default

If you had set up a PHP version for your site different that your server's default using your hosting control panel interface please keep in mind that this takes place by modifying your .htaccess file. Generating a new .htaccess file overwrites the old one, removing the lines your hosting control panel added or modified at the end of the file.

If you believe this is the case, please go back to your hosting control panel and re-apply the new PHP version. The take a look at the information in the .htaccess Maker documentation to copy the necessary .htaccess lines into Admin Tools' .htaccess Maker configuration. You can then create the .htaccess file again; the effective PHP version of your site will not change now.