Skip to content

Uninstall (PrestaShop)

Use this page when you need to remove the PrestaShop module cleanly, audit residual module data after an uninstall, or plan a reinstall.

  • The module must be uninstalled, not merely disabled. Disabling the module keeps all data; uninstalling removes it.
  • Uninstalling requires the PrestaShop module-management permission.
  • The uninstall process is irreversible for the data the module owns. The PrestaShop core data (products, categories, customers, orders) is never touched.

The PrestaShop module’s uninstall process runs the standard PrestaShop uninstall flow plus a module-specific cleanup. It does all of the following:

  1. Removes the index data owned by the module. The module-owned index data is the bulk of the cleanup. This is a destructive step and is not recoverable — the index must be rebuilt from the catalog by a future install.
  2. Removes the visibility configuration key from the PrestaShop configuration. All other Kea configuration keys are kept so a future install starts from a known state.
  3. Removes the module-owned registry rows that hold published bundles (the module-owned static-asset store).
  4. Wipes the reindex queue. Any reindex jobs that were scheduled are removed. If a reindex was already in progress when you uninstall, it will continue until its current step finishes and then exit; the uninstall does not stop an in-progress job.
  5. Removes the dashboard tabs registered by the module.

The uninstall does not:

  • remove the module’s source code directory from the PrestaShop modules directory (the directory the module was uploaded to);
  • remove non-visibility Kea configuration keys (KEA_*) — only the visibility key is removed;
  • remove PrestaShop core data (products, categories, customers, orders, themes);
  • remove the global PrestaShop cron task. The PrestaShop cron task is shared across modules and is not modified.

To remove the module’s source code, use the PrestaShop “Delete” button on the module’s row in Modules → Module Manager after uninstall. The “Delete” step is separate from “Uninstall” in PrestaShop. The docs use the term “uninstall” to mean the data and configuration cleanup, and “delete” to mean the file removal.

Item Kept? Why
The module’s source code directory (the directory the module was uploaded to) Kept PrestaShop “Delete” is a separate step
Other KEA_* configuration keys Kept Lets a future install start from a known state
PrestaShop products, categories, customers, orders Kept The module does not touch PrestaShop core data
PrestaShop global cron task Kept Shared across modules
Theme files (the replace mode does not write to the active theme) Kept The module does not install theme overrides in the current release
Custom theme overrides added by the merchant directly Kept The uninstall does not revert theme edits; the merchant must remove them manually
Customer data and order history Kept Out of scope for the module
  1. Go to Modules → Module Manager.
  2. Find Kea Labs Search Pro in the list.
  3. Click the Uninstall button on the module row. Confirm.
  4. (Optional) Click Delete to remove the module’s source code from the PrestaShop modules directory.

The PrestaShop module can be uninstalled from the command line through the standard PrestaShop CLI. Use the PrestaShop back office path unless you are scripting across many stores.

To verify a clean uninstall, audit the PrestaShop configuration for Kea keys and check that the module row is marked as uninstalled in the PrestaShop module list. The module list in the PrestaShop back office is the canonical reference for the uninstall state.

A clean uninstall leaves:

  1. The Kea visibility key is removed from the PrestaShop configuration.
  2. The other Kea keys remain (they are seeded on the next install).
  3. The PrestaShop module list shows the module as uninstalled.

If the audit shows residual module data, the uninstall was interrupted. Re-run the uninstall from the PrestaShop back office. The removal steps are idempotent.

After an uninstall, the module can be reinstalled as if for the first time. Reinstall:

  1. Wipes the residual module-owned data (if any).
  2. Re-seeds the configuration keys in the PrestaShop configuration.
  3. Enqueues a fresh reindex job.

If you want a “factory fresh” reinstall, the safest sequence is:

  1. Uninstall the module from the PrestaShop back office.
  2. (Optional) Delete the module row and the module’s source code directory.
  3. Re-upload the module via Modules → Module Manager → Upload a module.

For a normal uninstall / reinstall, step 2 is not required.

Symptom Most likely cause Resolution
Module data is still present after uninstall The uninstall was interrupted or the method timed out Re-run the uninstall; the removal calls are idempotent
The visibility configuration key is still present The visibility-key removal step did not run Remove the key from the PrestaShop configuration manually; check the module’s logs for errors
Custom theme overrides are still in the theme The merchant added them directly; the module does not install or remove theme overrides Inspect the theme and remove the overrides
A reindex was running at uninstall time The uninstall removes the queue; a reindex that is already in progress runs to the end of its current step and then exits This is expected; the reindex does not resume after uninstall

Uninstall is not a true rollback path: the index data and the asset registry are gone, and the search must be rebuilt from the catalog on the next install.

If you uninstall by mistake:

  • Reinstall the module. The next install will re-seed the configuration and re-run the reindex.
  • No PrestaShop core data is lost. The module does not touch products, categories, customers, or orders.
  • Customization is not preserved. Any custom theme overrides that the merchant added are not removed by uninstall. They remain on the theme; the merchant can remove them manually if desired.