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

With Admin Tools 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

WAF exceptions

Includes the list of URLs were Admin Tools should be deactivated

IP Blacklist

The permanently blacklisted IP addresses from the IP Blacklist page

IP Whitelist

The whitelisted administrator IP addresses from the IP Whitelist page

Bad words

All the words that are flagged as spam and should be blocked

Email templates

All email templates from the Email Templates page

After selecting what you want to export click on the Export settings button. 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. The imported settings will overwrite your existing settings.