--- label: 'Uninstalling a module' related: - core.extending - system.module_install - system.maintenance_mode --- {% set uninstall_url = render_var(url('system.modules_uninstall')) %} {% set maintenance_topic = render_var(url('help.help_topic', {'id': 'system.maintenance_mode'})) %}

{% trans %}Goal{% endtrans %}

{% trans %}Uninstall a module. Your site should be in maintenance mode when you uninstall modules.{% endtrans %}

{% trans %}Steps{% endtrans %}

  1. {% trans %}In the Manage administrative menu, navigate to Extend > Uninstall.{% endtrans %}
  2. {% trans %}Enter a word from the module name or description into the filter box, to make the list of modules smaller. Locate the module you want to uninstall.{% endtrans %}
  3. {% trans %}In the Description column, see if there are reasons that this module cannot be uninstalled. For example, you may have created content using this module (which you would need to delete first), or there may be another module installed that requires this module to be installed (you would need to uninstall the other module first).{% endtrans %}
  4. {% trans %}If there are no reasons listed, the module can be uninstalled. Check the box in the Uninstall column, next to the module's name.{% endtrans %}
  5. {% trans %}Click Uninstall at the bottom of the page. Verify the list of modules to be uninstalled and configuration to be deleted on the confirmation page, and click Uninstall.{% endtrans %}
  6. {% trans %}Wait for the module to be uninstalled. You should be returned to the Uninstall page with a message saying the module was uninstalled.{% endtrans %}