# How to Disable the OpenMage CSS/JS Minify Module: 3 Methods Explained

> Control OpenMage CSS/JS Minify module easily. Learn 3 effective methods to disable minification in Magento, including XML configuration and observer overrides for developers.

- Repository: [Fabrizio Balliano/openmage-cssjs-minify](https://github.com/fballiano/openmage-cssjs-minify)
- Tags: how-to-guide
- Published: 2026-03-01

---

**Set the `<active>` flag to `false` in [`app/etc/modules/Fballiano_CssjsMinify.xml`](https://github.com/fballiano/openmage-cssjs-minify/blob/main/app/etc/modules/Fballiano_CssjsMinify.xml) or override it via [`local.xml`](https://github.com/fballiano/openmage-cssjs-minify/blob/main/local.xml) to prevent Magento from registering the minification observer.**

The OpenMage CSS/JS Minify module automatically compresses frontend assets to improve page load times. However, developers may need to disable the OpenMage CSS/JS Minify module during debugging, development, or when troubleshooting conflicts. This guide explains the three supported methods to deactivate the module safely without removing the codebase.

## How the Module Activation System Works

### Module Registration via XML

In Magento's modular architecture, the file [`app/etc/modules/Fballiano_CssjsMinify.xml`](https://github.com/fballiano/openmage-cssjs-minify/blob/main/app/etc/modules/Fballiano_CssjsMinify.xml) serves as the primary registration point. This XML declaration contains the `<active>true</active>` node that instructs Magento to load the module into the runtime. When this flag evaluates to false, Magento ignores the module entirely during the config merging phase.

### The Observer and Cron Configuration

Inside [`app/code/community/Fballiano/CssjsMinify/etc/config.xml`](https://github.com/fballiano/openmage-cssjs-minify/blob/main/app/code/community/Fballiano/CssjsMinify/etc/config.xml), the module declares a critical observer for the `http_response_send_before` event (typically found around lines 17-24). This observer intercepts HTTP responses to inject minified assets. Additionally, the configuration defines a nightly cron job for cleanup operations. Disabling the module prevents both the observer registration and cron task execution.

## Method 1: Edit the Original Module Declaration

The most direct approach involves modifying the core module registration file. Navigate to [`app/etc/modules/Fballiano_CssjsMinify.xml`](https://github.com/fballiano/openmage-cssjs-minify/blob/main/app/etc/modules/Fballiano_CssjsMinify.xml) and change the active flag:

```xml
<?xml version="1.0"?>
<config>
    <modules>
        <Fballiano_CssjsMinify>
            <active>false</active>
            <codePool>community</codePool>
        </Fballiano_CssjsMinify>
    </modules>
</config>

```

This method immediately disables the module upon cache refresh. However, editing the original file complicates future updates, as package upgrades may overwrite your changes.

## Method 2: Create a Local Override File (Recommended)

For version-controlled projects, create an override file at the same path: [`app/etc/modules/Fballiano_CssjsMinify.xml`](https://github.com/fballiano/openmage-cssjs-minify/blob/main/app/etc/modules/Fballiano_CssjsMinify.xml). Magento merges all XML configurations, and the last definition takes precedence. Your override should contain:

```xml
<?xml version="1.0"?>
<config>
    <modules>
        <Fballiano_CssjsMinify>
            <active>false</active>
            <codePool>community</codePool>
        </Fballiano_CssjsMinify>
    </modules>
</config>

```

Place this file in your repository's `app/etc/modules/` directory. This approach survives module updates and clearly documents the disabled state in your version control system.

## Method 3: Disable via local.xml

Alternatively, inject the deactivation into [`app/etc/local.xml`](https://github.com/fballiano/openmage-cssjs-minify/blob/main/app/etc/local.xml) or any other merged configuration file. This centralizes module management within your local environment configuration:

```xml
<?xml version="1.0"?>
<config>
    <modules>
        <Fballiano_CssjsMinify>
            <active>false</active>
        </Fballiano_CssjsMinify>
    </modules>
</config>

```

Note that [`local.xml`](https://github.com/fballiano/openmage-cssjs-minify/blob/main/local.xml) loads after module declarations, ensuring your false value overrides the default true setting. This method is ideal for multi-environment deployments where you want to disable the module only in specific instances (like development or staging).

## Verifying the Module is Disabled

After applying any method, clear Magento's cache to ensure configuration changes take effect. Remove cached files manually:

```bash
rm -rf var/cache/*

```

Or use the Cache Management interface in the admin panel. Once cleared, verify the module status by checking that:

- The `http_response_send_before` observer no longer triggers minification
- No new minified files appear in `media/css/` or `media/js/`
- The nightly cleanup cron job does not execute

## Summary

- The OpenMage CSS/JS Minify module activates via [`app/etc/modules/Fballiano_CssjsMinify.xml`](https://github.com/fballiano/openmage-cssjs-minify/blob/main/app/etc/modules/Fballiano_CssjsMinify.xml) with an `<active>true</active>` flag.
- Disabling the module prevents Magento from registering the `http_response_send_before` observer and the cleanup cron job defined in [`config.xml`](https://github.com/fballiano/openmage-cssjs-minify/blob/main/config.xml).
- Three methods exist: editing the original file (quick but fragile), creating a local override (version-control friendly), or using [`local.xml`](https://github.com/fballiano/openmage-cssjs-minify/blob/main/local.xml) (environment-specific).
- Always clear the cache after disabling to ensure the configuration change takes effect.

## Frequently Asked Questions

### What happens to existing minified files when I disable the module?

Existing minified CSS and JS files in the media directory remain untouched but are no longer updated or referenced. The module's cleanup cron job stops executing, so old minified files persist until manually deleted or until you re-enable the module with cleanup enabled.

### Will disabling the module break my storefront?

No, disabling the module safely reverts your store to serving standard uncompressed assets. Since the `http_response_send_before` observer no longer intercepts responses, Magento delivers the original CSS and JS files without modification. This ensures full functionality while sacrificing the performance benefits of minification.

### Do I need to clear cache after disabling the module?

Yes, clearing the cache is mandatory. Magento compiles configuration XML into cached structures in `var/cache/`. Until you remove these cached files or flush the cache via the admin panel, Magento may continue using the previous configuration where the module was active, causing the minification observer to still trigger.

### Can I disable the module for specific store views only?

No, Magento's module activation system operates at the global level via the `<active>` flag in module XML declarations. You cannot disable the OpenMage CSS/JS Minify module for individual store views or websites while keeping it active for others. To achieve store-specific behavior, you would need to keep the module active but modify its configuration to check the current store scope before executing minification logic.