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.

Import and Exporting Settings

Sometimes you need to be able to import and export Admin Tools it. Some indicative use cases are:

  • Backing up your Admin Tools settings before trying massive changes which could break your configuration

  • Transferring your settings to another site on the same or an identical server

  • Copying the IP white- and black-lists or email templates

Since Admin Tools 3.1.0 you can do that through the Export Settings and Import Settings pages of the component.


Exporting and importing very large datasets (more than a thousand rows) IS NOT RECOMMENDED and CAN LEAD TO TIMEOUT ERRORS. This is a limitation of PHP, namely the memory_limit (maximum memory usage limit) and max_execution_time (maximum time to execute the page) imposed by your server's php.ini. Besides, it is a very bad idea having so many IP white-/black-list and/or email template rows as your site's performance would become extremely bad. If you find yourself putting more than 100 records into these features you are doing something really wrong.

Exporting Settings

In this page you can choose which settings you want to export. The available options are:

WAF configuration

This includes all settings in the Configure WAF, .htaccess Maker and NginX Configuration Maker pages

IP Disallow List

The permanently disallowed IP addresses from the IP Disallow List page

Exclusive Allow IP List

The allowed administrator IP addresses from the Exclusive Allow IP List page

Email templates

All email templates from the Email Templates page

After selecting what you want to export click on the Export settings button in the toolbar. Your browser will download a JSON file with all of the selected configuration settings.

Importing Settings

Choose the exported JSON file and click on the Import settings button in the toolbar. The imported settings will overwrite your existing settings.