Manage the indexers
In addition to the command arguments described in this topic, see Common arguments.
Run all Magento CLI commands as the Magento file system owner.
View a list of indexers
To view a list of all indexers:
1
bin/magento indexer:info
The list displays as follows:
1
2
3
4
5
6
7
8
9
10
design_config_grid Design Config Grid
customer_grid Customer Grid
catalog_category_product Category Products
catalog_product_category Product Categories
catalog_product_price Product Price
catalog_product_attribute Product EAV
catalogrule_rule Catalog Rule Product
catalogrule_product Catalog Product Rule
cataloginventory_stock Stock
catalogsearch_fulltext Catalog Search
View indexer status
Use this command to view the status of all indexers or specific indexers. For example, find out if an indexer needs to be reindexed.
Command options:
1
bin/magento indexer:status [indexer]
[indexer] is a space-separated list of indexers. Omit [indexer] to view the status of all indexers.
To list all indexers:
1
bin/magento indexer:info
A sample follows:
1
bin/magento indexer:status
Sample result:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
+----------------------+------------------+-----------+---------------------+---------------------+
| Title | Status | Update On | Schedule Status | Schedule Updated |
+----------------------+------------------+-----------+---------------------+---------------------+
| Catalog Product Rule | Reindex required | Save | | |
| Catalog Rule Product | Reindex required | Save | | |
| Catalog Search | Ready | Save | | |
| Category Products | Reindex required | Schedule | idle (0 in backlog) | 2018-06-28 09:45:53 |
| Customer Grid | Ready | Schedule | idle (0 in backlog) | 2018-06-28 09:45:52 |
| Design Config Grid | Ready | Schedule | idle (0 in backlog) | 2018-06-28 09:45:52 |
| Product Categories | Reindex required | Schedule | idle (0 in backlog) | 2018-06-28 09:45:53 |
| Product EAV | Reindex required | Save | | |
| Product Price | Reindex required | Save | | |
| Stock | Reindex required | Save | | |
+----------------------+------------------+-----------+---------------------+---------------------+
Reindex
Use this command to reindex all, or selected indexers, one time only.
This command reindexes one time only. To keep indexers up-to-date, set up a cron job.
Command options:
1
bin/magento indexer:reindex [indexer]
[indexer] is a space-separated list of indexers. Omit [indexer] to reindex all indexers.
To view a list of all indexers:
1
bin/magento indexer:info
A sample follows:
1
bin/magento indexer:reindex
Sample result:
1
2
3
4
5
6
7
8
Category Products index has been rebuilt successfully in <time>
Product Categories index has been rebuilt successfully in <time>
Product Price index has been rebuilt successfully in <time>
Product EAV index has been rebuilt successfully in <time>
Stock index has been rebuilt successfully in <time>
Catalog Rule Product index has been rebuilt successfully in <time>
Catalog Product Rule index has been rebuilt successfully in <time>
Catalog Search index has been rebuilt successfully in <time>
Reindexing all indexers can take a long time for stores with large numbers of products, customers, categories, and promotional rules. To reduce processing time, see the next section for reindexing in parallel mode.
Reindex in parallel mode
As of Magento 2.2.6, indexers are scoped and multi-threaded to support reindexing in parallel mode. This feature reduces processing time. It parallelizes by the indexer’s dimension and executes across multiple threads.
These indexes can be run in parallel mode:
- Catalog Search Fulltext can be paralleled by store views.
- Category Product can be paralleled by store views.
- Catalog Price can be paralleled by website and customer groups.
By default, Catalog Price does not use a partitioning into dimension.
If you want to use parallelization you need to set one of available modes of dimensions for product price indexer:
none(default)websitecustomer_groupwebsite_and_customer_group
For example, to set the mode by website run:
1
bin/magento indexer:set-dimensions-mode catalog_product_price website
To check the current mode you can use next command:
1
bin/magento indexer:show-dimensions-mode
To reindex in parallel mode, run the reindex command using the environment variable MAGE_INDEXER_THREADS_COUNT, or add an environment variable to env.php. This variable sets the number of threads for the reindex processing.
For example, the following command runs the Catalog Search Fulltext indexer across three threads:
1
MAGE_INDEXER_THREADS_COUNT=3 php -f bin/magento indexer:reindex catalogsearch_fulltext
Configure indexers
Use this command to set the following indexer options:
- Update on save (
realtime) - Indexed data is updated as soon as a change is made in the Admin. (For example, the category products index is reindex after products are added to a category in the Admin.) This is the default. - Update by schedule (
schedule) - Data is indexed according to the schedule set by your Magento cron job.
Display the current configuration
To view the current indexer configuration:
1
bin/magento indexer:show-mode [indexer]
[indexer] is a space-separated list of indexers. Omit [indexer] to show all indexers’ modes. For example, to show the mode of all indexers:
1
bin/magento indexer:show-mode
Sample result:
1
2
3
4
5
6
7
8
Category Products: Update on Save
Product Categories: Update on Save
Product Price: Update on Save
Product EAV: Update on Save
Stock: Update on Save
Catalog Rule Product: Update on Save
Catalog Product Rule: Update on Save
Catalog Search: Update on Save
Configure indexers
To specify the indexer configuration:
1
bin/magento indexer:set-mode {realtime|schedule} [indexer]
realtime sets the selected indexers to update on save.
schedule sets the specified indexers to save according to the cron schedule.
indexer is a space-separated list of indexers. Omit indexer to configure all indexers the same way.
To view the list of indexers:
1
bin/magento indexer:info
For example, to change only the category products and product categories indexers to update on schedule, enter:
1
bin/magento indexer:set-mode schedule catalog_category_product catalog_product_category
Sample result:
1
2
Index mode for Indexer Category Products was changed from 'Update on Save' to 'Update by Schedule'
Index mode for Indexer Product Categories was changed from 'Update on Save' to 'Update by Schedule'
