make magento custom attribute filterable

make magento custom attribute filterable

October 10, 2026 · Illustrated author avatarBy Stefan Bogdanescu
make magento custom attribute filterable

Making Custom Magento Attributes Filterable via Setup Files

Creating filterable custom attributes in Magento can be a bit tricky if you’re not sure where to look or what settings to adjust. In this post, we’ll guide you through the process of making an attribute filterable using setup files - specifically the setup/install-0.1.0.php and resource/eav/mysql4/setup.php.

Understanding Filterable Attributes

Before diving in, let’s clarify what it means for an attribute to be ‘filterable’. When an attribute is set as filterable:

  • It appears in the layer navigation filters on the frontend.
  • It can be used for layered navigation.
  • It contributes to search results relevance.

Setting Up Your Custom Attribute

Firstly, ensure your custom attribute is configured correctly. You should have a file structure like this:

app/code/local/Company/Module/Model/sql/module_setup/mysql4-install-0.1.0.php
app/code/local/Company/Module/Model/Resource/Eav/Mysql4/Setup.php

In the mysql4-install-0.1.0.php file, you should have the following:

public function installEntities()
{
    $installer = Mage::getResourceModel('catalog/setup', 'eav_setup');
    $installer->startSetup();

    // Your attribute setup goes here

    $installer->endSetup();
}

Configuring the Attribute

The real magic happens in your Setup.php file under the getDefaultEntities() method. Here is where you define all the default attributes for your product:

public function getDefaultEntities()
{
    return array(
        'catalog_product' => array(
            // Other default entities...
            'attributes' => array(
                'attribute_name' => array(
                    // Other attribute settings...
                    'filterable'                 => 1,
                    // Other settings...
                ),
            ),
        ),
    );
}

In the attributes array, you specify your custom attribute. Under this, set 'filterable' to 1. This tells Magento that the attribute should be filterable.

Avoiding Common Pitfalls

Remember a few key points:

  • The filterable setting only works if enabled in the admin panel as well.
  • If you’re using an existing attribute group, ensure its settings are compatible with your new attribute.
  • Always clear cache after making attribute changes.

Conclusion: Making Magento Custom Attributes Filterable

By following this guide, you should now be able to make custom attributes filterable through setup files in Magento. This approach offers a clean and efficient way to configure your product attributes during installation.

Remember, the key is setting 'filterable' to 1 in the appropriate section of your Setup.php file. If you’re still having trouble, feel free to explore our Magento development resources for more detailed tutorials and examples.

Happy coding!

Catalog Database Extensions Configuration

Our network