All docs

Backup & Migration

Everything you set up in AI Boost lives in your Joomla database. Backup & Migration writes it into one file you can keep, and reads such a file back, on this site or on another. Take a copy before a change you are unsure of and before you uninstall. Use the same file to set up a second site the way the first one is.

It is the third screen under Tools in the sidebar, and it has four numbered sections. Export and import share the first, the report on a chosen file is the second, Past imports is the third, and removing every setting is the fourth. The picture below comes from an earlier version, before Past imports was added, so it shows three.

Backup & Migration before a file is chosen. Section 01, Export and import settings, has the Export settings file and Choose file buttons side by side above the notice It does carry the codes you typed in. Section 02, What this file would change, waits for a file above the two answers to How should this be applied. Section 03, Remove every setting, holds the Remove all settings button

Export and import settings

The section has two halves, Export a settings file on the left and Import a settings file on the right. The notice under both belongs to the export. It warns that the file carries the codes you typed in, and is covered below.

Export a settings file

Export settings file builds the file on your site and your browser downloads it, named with the day's date, such as aiboost-settings-2026-09-28.json. Nothing is sent anywhere else.

The file holds every setting on every AI Boost screen, including the ones you never changed, and every rule from Redirects & 404s with its address, target, type, note and whether it is on. It also holds Multilang's translations, whether Multilang is switched on or not. It holds no licence key, no 404 log and no error log, and it does not carry how often each redirect was used. What your editors typed into AI Boost's fields on articles, categories and user profiles is Joomla content, so it is not in the file either. A page's Indexed answer on Pages is kept with that page in Joomla, so the file does not carry it. Its In sitemap answer is an AI Boost setting, so the file does carry it.

The line under the button says the file holds your settings and redirect rules and no logs, and names some of what those settings carry, among them your VAT number, your IndexNow key and the code in your Custom Code boxes. The notice under both halves names your Google Search Console, Bing Webmaster and Meta verification codes and your analytics IDs. Your business name, address, e-mail and telephone are in the file too, because it holds everything you typed into the settings. Keep it where you keep other private files. Import it onto a different site and that site publishes the same codes and reports its visits into your analytics.

From AI Boost 1.1.0, an uninstall keeps your settings on this site, so you need the file to move them to another site or to keep a copy outside the database. Uninstalling AI Boost says what an uninstall keeps and what to do before one.

Import a settings file

Choose file takes a .json file exported from AI Boost. Choosing it writes nothing. AI Boost reads the file, compares it with this site, and shows the result in section 02, What this file would change.

AI Boost refuses a file that is not an AI Boost settings file, one that was cut short while downloading, one far larger than any settings file, and one that carries neither a setting this version knows nor a redirect rule it can read. It also refuses a file that a newer version of AI Boost wrote in a format this version cannot read. The screen says why, and nothing is written. For the newer file, update AI Boost on this site, then try it again.

Some settings work only on a site that has been activated, such as Markdown copies, FAQ, Event and author structured data, and every Schema Type other than Organization and LocalBusiness. Getting started lists them all. A site that has not been activated leaves each of them as it is when it reads a file, and the report names them. Activate the site first, then import.

What this file would change

Before you choose a file, this section says the report appears here before anything is written. Once AI Boost has read one, the report starts with when the file was taken, which AI Boost version made it beside the version on this site, and when this site read it. Under that, a row of counts sorts every setting the file names:

CountWhat it means
newThis site has never stored the setting, and the file sets it to something other than the default
changedThis site holds a different value, and the file's value will replace it
already the sameNothing changes
kept as they areThis site holds a different value and keeps it, because you chose to fill in only what is missing
not recognisedAn entry this version does not know, usually one a later version of AI Boost wrote, or a value it cannot read
cannot be storedA value this site will not hold for that setting
not taken as writtenFrom 1.1.1. A value this version cannot hold as the file writes it, such as a choice the setting does not offer, a switch written as yes, or a number with a fraction. AI Boost stores what it can instead, the setting's default for a choice it does not offer
retiredFrom 1.1.1. A setting an earlier version of AI Boost retired. The site leaves it out
need an activated siteA setting the file would change that works only on a site that has been activated. This site is not, so it keeps the value it has

The last ones, from not recognised on, appear only when there is something to count. When the file carries redirect rules, a second row headed Redirect rules does the same for them, matched by the address they redirect from. On that row, cannot be stored counts rules in the file that lack an address or a target, or whose address, target or note is too long to keep.

The blue line under the counts says how many settings on this site the file does not mention. They keep their values. A file exported by this version of AI Boost names every setting, so the line says it leaves out none. A number above nought usually means an older file. When this site has redirect rules the file does not name, the line counts them too, and they stay as they are. An import adds and replaces, and never deletes a setting or a redirect rule.

Open Settings this file would change before you import. It lists each changed setting with its value On this site now and In the file. The lists under it name the new settings, the kept ones, the ones the file does not mention, the ones left as they are because this site is not activated, and those it cannot store or does not recognise. The list of settings left as they are opens by itself, with an Activate licence link to Plan & Updates.

From 1.1.1, two more lists name what the file cannot bring across as it is. The settings this version cannot take as written are listed with their value In the file and the value Stored instead. The retired settings are listed with the version that retired them, such as retired in 1.0.0. Neither stops the import. Read both before you go on, because a value stored instead is not the one you exported.

Custom Code follows the same rules as every other setting. The one difference is who may change it.

Custom Code has three boxes, Head, Body Start and Body End. With Use the file's values, each box takes the file's code where it differs. A box that is empty in the file empties yours.

When a file would change Custom Code or its switch, a Super User sees the warning This file carries the Custom Code settings. above the counts. Read the changed rows before you go on.

Only a Super User can change that code. Anyone else sees Nothing in this file can be applied. in its place, and Import these settings stays off. AI Boost refuses the whole file rather than apply part of it.

With Only fill in what is missing, a box this site already holds keeps its code. That box stops counting as a change. If no code change is left in the file, the refusal lifts.

How should this be applied?

  • Use the file's values. Every setting the file names takes the file's value. This is chosen when the screen opens, and again after Cancel or Clear this report.
  • Only fill in what is missing. Choose it when this site is already set up the way you want and the file should only add to it. Every value this site has saved wins over the file, redirect rules included, so a rule for an address this site already has keeps its target. A setting you never changed was never saved, so the file sets it.

Changing the choice reads the file again and redraws the report. Import these settings is the only button on the screen that writes an imported file. Cancel drops the file and writes nothing.

Afterwards the heading becomes What this file changed, and a line says how many settings and redirect rules were written. If some could not be stored, the line says how many and they are listed above it. From 1.1.1, the values stored instead and the retired settings are listed there too. Clear this report empties the section.

Past imports

From 1.1.1, each import you apply leaves a record in this section, and the last 20 are kept. The list shows when each import ran, who ran it, which AI Boost version wrote the file, how many values it replaced and how many were not imported as written. Open shows one record in full.

  • Each value the import replaced, with its value Before and After.
  • The redirect rules it added or changed, and the rules in the file this site did not store.
  • What did not go in as written. That covers the entries it did not recognise, the values it could not store, the values stored instead and the retired settings.

Download record saves the record as a file. A record cannot undo an import. To go back, import a settings file you exported before.

An uninstall keeps the records, as it keeps your settings. Remove all settings… deletes them.

A worked example

The Aldwick Lane Hotel built its AI Boost setup on a test copy of its site, then moved it to example.com.

  1. On the test copy, Export settings file.
  2. On the live site, it activated the site on Plan & Updates first, so the Hotel type and the other settings that need an activated site would arrive too. Then it pressed Choose file. The live site had AI Boost installed with nothing set up, so every setting the hotel had changed on the test copy arrives as new, and the rest are already the same.
  3. It kept Use the file's values and pressed Import these settings.
  4. The test copy's codes came across with everything else, so the hotel opened Analytics & Verification and checked each one against its live accounts.

A sister hotel that wants the same setup imports the same file the same way, then replaces the business details on Structured Data, every code on Analytics & Verification, the OG Site Name, Twitter / X Site Handle and Facebook App ID on Social Sharing, and the Site Description for AI and the IndexNow key on AI Discovery. Until it does, its pages can carry the Aldwick Lane Hotel's name, address and verification codes as its own.

Remove every setting

The section's notice warns that this removes every setting on this site, and calls it the one thing on the screen that cannot be undone. Remove all settings… opens a window that asks you to confirm before anything is removed. Once removed, only a file you exported first brings the settings back.

The window, Remove every AI Boost setting, offers Export settings file first. Take it, because that file is the only way back. It then lists what goes and what stays.

  • What goes. Every AI Boost setting, including the switches on Redirects & 404s and Debug and each page's In sitemap answer on Pages, the last Site Health result, Multilang's translations, and from 1.1.1 the records under Past imports. The site then starts over the way a fresh installation does.
  • What stays. Your licence key, your redirect rules, the Indexed answer you gave each page on Pages, the 404 log, the error log, the history of address checks, and the fields AI Boost added to articles, categories and user profiles. None of your Joomla content is touched.

Type reset-all into the box to switch on Remove all settings, and press it. When it is done, press Reload the admin to see the site as a fresh installation shows it.

Use this when a setup has drifted so far that starting over is quicker than fixing it. It keeps your licence key and your redirect rules. From 1.1.0, an uninstall keeps the settings too, so uninstalling and reinstalling does not start you over.

Check it on your site

After an import, open the Dashboard. Each card shows its screen's switches, so you see at a glance what the file switched on. Then look at your site as a visitor, and check the pages that matter most on Pages, Check addresses.