This documentation page is for Joomla! 3.x

This documentation page does not apply to our software versions for Joomla! 4.0 and later versions. If you are not using Joomla 3 please consult the documentation index to find and read the correct version of the documentation.

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. 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.