Skip to content

Guide to Uninstall E-commerce Modules in Odoo

Context

In this Odoo installation, when you attempt to uninstall certain e-commerce modules (emipro_*), you’ll see related modules listed for removal in cascade (e.g. website_sale_uom, cnf_inventory_sync, etc.).
To avoid deleting critical functionality, this guide provides a precise, step-by-step pathβ€”using the exact module names and orderβ€”so you only remove what you don’t need.


Before You Begin: Environment & Recommendations

  • Work in Development or Staging, never directly in Production.
  • Enable Developer Mode: Navigate to Settings β†’ Activate Developer Mode to access technical menus.
  • Backup your database and source code before each phase.

Emipro Modules (Initial State)

Emipro modules installed
Image 1 – Initial list of installed Emipro modules


Phase 1: Attempt to Uninstall emipro_theme_banner_video

1. Try Uninstalling the Module

  • Go to Apps β†’ Installed Modules
  • Find emipro_theme_banner_video and click Uninstall
  • A pop-up window appears listing dependent modules that would be removed

Uninstall dialog with dependencies
Image 2 – Uninstall confirmation dialog showing dependent modules

2. Comment Out Dependency in website_sale_uom

Edit website_sale_uom/__manifest__.py and comment out the cnf_theme_customizeations line:

'depends': [
    'website_sale',
    'sale_stock',
    'uom',
-  # 'cnf_theme_customizeations',
]

3. Comment Out Dependencies from CNF Modules

3.1 In cnf_inventory_sync/__manifest__.py

'depends': [
    'stock',
-  # 'theme_clarico_vega'
]

3.2 In cnf_product_addons/__manifest__.py

'depends': [
    'base',
-  # 'theme_clarico_vega',
    ...
],
'data': [
    'views/product_brand.xml',
-  # 'views/product_tabs.xml',
]

3.3 cnf_cart_customizations/__manifest__.py

'depends': [
    'base',
-  # 'theme_clarico_vega',
    ...
]

4. Prepare cnf_theme_optimization for Removal

Edit cnf_theme_optimization/__manifest__.py:

'data': [
-  # 'templates/quick_filter.xml',
]

Comment out the following files:

  • templates/products_attributes_ept.xml
  • templates/quick_filter.xml

5. Restart Odoo

6. Upgrade cnf_product_addons

  • Go to Apps β†’ Installed
  • Click Upgrade on cnf_product_addons

7. Upgrade website_sale_uom

  • Go to Apps β†’ Installed
  • Click Upgrade on website_sale_uom

βœ… Result of Phase 1

The uninstall dialog for emipro_theme_banner_video has been significantly reduced. Several dependent modulesβ€”such as website_sale_uom, cnf_inventory_sync, cnf_product_addons, cnf_cart_customizations, connector_cnf_inventory, cnf_product_merge, and account_sage_reportsβ€”are no longer blocking the uninstall process. However, the module cannot yet be uninstalled completely due to remaining dependencies, which will be resolved in the next phase.

Updated uninstall dialog Image 3 – Uninstall dialog showing progress after initial dependency cleanup


Phase 2: Uninstall theme_clarico_vega

1. Locate cnf_theme_optimization Module

  • Go to Apps
  • Clear any filters
  • Search for cnf_theme_optimization

Module search
Image 4 – Finding the cnf_theme_optimization module in the Apps menu

2. Open Technical Data

  • Click Module Info
  • Go to the Technical Data tab

Technical data tab
Image 5 – Accessing technical metadata of the module

3. View Dependencies

  • Click on theme_clarico_vega under the Dependencies section

Dependency view
Image 6 – theme_clarico_vega listed as a required dependency

4. Uninstall the Theme

  • In the popup, click Theme Clarico Vega, then click Uninstall, and finally click Confirm

Uninstall confirmation
Image 7 – Final uninstall dialog for theme_clarico_vega

Modules auto-marked for removal
Image 8 – Modules auto-marked for removal when theme_clarico_vega is uninstalled


βœ… Result of Phase 2

The theme_clarico_vega module and its dependencies have been successfully removed from the system.

Theme-related cleanup confirmation
Image 9 – Confirmation dialog after removing theme_clarico_vega


Phase 3: Clean Up emipro_* Modules

Modules to Uninstall

emipro_theme_banner_video
emipro_theme_category_carousel
emipro_theme_category_listing
emipro_theme_landing_page
emipro_theme_lazy_load
emipro_theme_load_more
emipro_theme_product_carousel
emipro_theme_product_label_extended
emipro_theme_product_tabs
emipro_theme_product_timer
emipro_theme_quick_filter
pwa_ept

Uninstall Process

  • Go to Apps β†’ Installed
  • Click Uninstall for each of the listed modules

Preserved Modules

emipro_theme_base
emipro_theme_brand
emipro_theme_product_label

Phase 4: Troubleshooting Common Uninstall Errors

⚠️ Follow this phase only if you encounter uninstall errors related to views or templates.
These typically occur when leftover views reference fields or templates from modules that have already been uninstalled.

Example error:
AttributeError: 'website' object has no attribute 'is_auto_play'

This happens when a view is trying to use a field that no longer exists because the module that defined it was removed.

1. Identify Orphaned Views

-- Connect to database
psql postgres://odoo:odoo@localhost:5432/communitynaturalfoods-master-963663

-- Search for views with references to removed theme fields
SELECT id, name, model, active 
FROM ir_ui_view 
WHERE arch_db::text LIKE '%is_auto_play%'
   OR name LIKE '%emipro%'
   OR name LIKE '%clarico%';

Common orphaned views: - slider_auto_play - References website.is_auto_play from removed theme - res.config.settings.emipro.base - Emipro theme configuration settings

2. Deactivate Orphaned Views

-- Deactivate identified orphaned views
UPDATE ir_ui_view 
SET active = false 
WHERE name IN ('slider_auto_play', 'res.config.settings.emipro.base');

-- Or more broadly, deactivate all theme-related orphaned views
UPDATE ir_ui_view 
SET active = false 
WHERE (arch_db::text LIKE '%is_auto_play%'
   OR name LIKE '%emipro%'
   OR name LIKE '%clarico%')
   AND name NOT IN (SELECT name FROM ir_model WHERE model LIKE 'product.%');

3. Restart Odoo and Verify

make restart

4. Delete Orphaned Views (Optional)

After confirming the system works correctly:

-- Delete deactivated orphaned views
DELETE FROM ir_ui_view 
WHERE active = false 
  AND (name LIKE '%emipro%' OR name LIKE '%clarico%' OR name = 'slider_auto_play');

Emipro Modules (Final State)

Final state of Emipro modules
Image 10 – Final state of Emipro-related modules after cleanup


πŸ”§ Future Tasks

  • πŸ” Reimplement the functionality of views/product_tabs.xml from cnf_product_addons into a dedicated custom module.
  • πŸ” Audit other CNF modules to identify unnecessary view or data files.
  • πŸ›  Refactor templates to align with the frontend theme architecture.
  • βœ… Document these changes in your technical migration logs.

Final Tips

  • βœ… Test Critical Workflows: Confirm everything still works as expectedβ€”checkout, inventory, and frontend navigation.
  • πŸ“ Keep Documentation Updated: Note which modules were removed and why.
  • ♻️ Plan for Rollback: Always keep a backup or snapshot.

πŸ“‹ Summary Table

Status Module Name Action
βœ… emipro_theme_banner_video Uninstalled
βœ… theme_clarico_vega Uninstalled
βœ… cnf_theme_customizeations Uninstalled
βœ… cnf_custom_snippets Uninstalled
πŸ’Ύ cnf_cart_customization Retained
βœ… cnf_theme_optimization Uninstalled
πŸ’Ύ cnf_inventory_sync (patched) Retained
πŸ’Ύ cnf_product_addons (patched) Retained
βœ… emipro_theme_category_carousel Uninstalled
βœ… emipro_theme_category_listing Uninstalled
βœ… emipro_theme_landing_page Uninstalled
βœ… emipro_theme_lazy_load Uninstalled
βœ… emipro_theme_load_more Uninstalled
βœ… emipro_theme_product_carousel Uninstalled
βœ… emipro_theme_product_timer Uninstalled
βœ… emipro_theme_quick_filter Uninstalled
βœ… emipro_theme_product_label_extended Uninstalled
βœ… emipro_theme_product_tabs Uninstalled
βœ… pwa_ept Uninstalled
πŸ”’ emipro_theme_base Preserved
πŸ”’ emipro_theme_brand Preserved
πŸ”’ emipro_theme_product_label Preserved