Skip to content

📝 Community Note The content on this page was generated with the assistance of AI and is pending a human review. While we've done our best to ensure accuracy, there may be discrepancies or areas that could be improved.

Indexers Documentation


Indexers are an essential component of Magento 2's architecture for efficient data retrieval. They play a significant role in improving the performance of your Magento store by pre-calculating and storing data in an optimized format, allowing for quick and efficient searching and filtering operations.

This documentation will provide you with a comprehensive understanding of indexers in Magento 2, including their purpose, types, configuration, and management.

What are Indexers?

In Magento 2, indexers are responsible for transforming raw data from your store's database into a format that is optimized for fast searching and filtering. They allow for efficient retrieval of data without the need for complex database queries, significantly improving the performance of read operations.

Indexers are a crucial part of Magento's architecture as they ensure real-time data accuracy while maintaining high performance. By updating only the affected portions of the index, Magento minimizes the time and resources required to keep the index up-to-date.

Types of Indexers

Magento 2 provides several built-in indexers, each designed to handle specific data entities and attributes. Here are some examples of the most commonly used indexers:

  1. Product Indexer: Handles product-related data, such as attributes, categories, prices, and stock status.
  2. Category Indexer: Manages category-related data, including category hierarchies, URLs, and product assignments.
  3. Customer Indexer: Maintains customer-related data, such as names, addresses, and account information.
  4. Order Indexer: Handles order-related data, including order status, customer details, and product information.

These are just a few examples, and depending on your specific Magento setup and extensions, you may have additional indexers available.

Indexer Configuration

Magento 2 provides a configuration file (etc/indexer.xml) that specifies the indexers and their corresponding index tables. This file is located in the module's directory, typically in app/code/[Vendor]/[Module]/etc/indexer.xml.

To configure an indexer, you define it in the indexer.xml file with its associated data source and index table. Here's an example of configuring a custom indexer:

<config xmlns:xsi=""
<indexer id="custom_indexer" view_id="custom_indexer" class="[Vendor]\[Module]\Indexer\CustomIndexer">
<title translate="true">Custom Indexer</title>
<description translate="true">This is a custom indexer for XYZ data.</description>
<dataSource name="[Vendor]\[Module]\Indexer\CustomIndexer\DataSource"/>
<indexTable name="[Vendor]_[Module]_custom_indexer"/>

In this example, we define a custom indexer with the identifier custom_indexer. The class attribute points to the indexer's implementation class. The dataSource element specifies the class responsible for retrieving the data to be indexed, while the indexTable element defines the name of the index table.

Managing Indexers

Magento 2 provides a range of commands to manage and interact with indexers via the command-line interface (CLI). These commands allow you to enable/disable, update, and manage the status of individual indexers.

To view the current status of all indexers, use the following command:

bin/magento indexer:status

To enable or disable a specific indexer, use the following command:

bin/magento indexer:set-mode <indexer_id> <mode>

For example, to enable the product indexer:

bin/magento indexer:set-mode catalog_product_attribute update

To update/reindex a specific indexer, use the following command:

bin/magento indexer:reindex <indexer_id>

For example, to reindex the product indexer:

bin/magento indexer:reindex catalog_product_attribute

Remember to run the necessary indexers after making configuration changes to ensure the data is up-to-date.

Indexer Troubleshooting

If you encounter issues with indexers, there are a few troubleshooting steps you can take:

  1. Check Indexer Status: Verify the status of all indexers using the bin/magento indexer:status command. Look for any indexers with a "Working" status or errors, as these could indicate potential issues.
  2. Check Logs: Examine the Magento logs, especially the system.log and exception.log, for any relevant error messages or exceptions related to indexers.
  3. Check Server Resources: Ensure that your server has sufficient resources (memory, CPU, disk space) to accommodate the indexing process. Insufficient resources can cause indexing failures or slowdowns.
  4. Reindex Manually: If the automated reindexing fails, try manually reindexing specific indexers using the bin/magento indexer:reindex command. Monitor the output for any error messages or warnings.
  5. Rebuild Index Tables: In some cases, rebuilding the index tables can resolve issues. This can be done by truncating the index table(s) associated with the problematic indexer(s) and then running a full reindex.

If the above steps do not resolve the issue, consider seeking assistance from the Magento community or support channels for further troubleshooting and debugging.


Indexers are a vital part of Magento 2's performance optimization strategy, allowing for efficient data retrieval and search operations. By understanding the different types of indexers, configuring them correctly, and managing them effectively, you can ensure your Magento store delivers fast and accurate results to your customers.

For additional information and advanced usage, refer to the official Magento 2 documentation and community resources. Happy indexing!