- Automatically with an indexing queue
- Manually from your store’s Magento Admin
- Manually on the command line
- Section reindex. The extension reindexes an entire catalog section (products, categories, or pages).
- Single item reindex. The extension reindexes one product, category, or page when it changes.
Enable Algolia indexing
To enable Algolia indexing, go to Stores > Algolia Search > Indexing Manager > Enable Indexing and select Yes.
Section reindex with an indexing queue
The indexing queue uses temporary indices to reindex products. Instead of updating the production directly, Algolia creates a temporary copy. It replaces the production index only after the update is complete. Index changes are visible once the temporary index replaces the production index. When you enable this option, the Algolia AI Search & Discovery extension speeds up indexing by running reads and writes on separate indices. Turn off this option if you need updates to appear in your index without waiting for a full reindex.Section reindex without an indexing queue
Without the indexing queue, reindexing the complete catalog is synchronous: everything has to wait until the process completes. Without a queue, reindexing uses more time and resources. It’s also less reliable: if you update products during a reindex, Algolia may serve outdated data.Automatic indexing
The Algolia AI Search & Discovery extension sends every change and deletion on products or categories to Algolia’s servers to keep all data up to date.Index manually
To index your data manually:Turn off the queue
To turn off the indexing queue,
set Stores > Configuration > Algolia Search > Indexing Queue/Cron > Enable Indexing Queue to No in the Magento Admin.
Send manual updates
Use the command line to send manual updates to Algolia’s server.
For example, to reindex all products:Use the same command for all other indices created by the extension:
| Command (version 3.16 and higher) | Command (version 3.15.x and lower) | Action |
|---|---|---|
algolia:reindex:all | Not available | Reindex all entities |
algolia:reindex:products | indexer:reindex algolia_products | Reindex all products |
algolia:reindex:categories | indexer:reindex algolia_categories | Reindex all categories |
algolia:reindex:pages | indexer:reindex algolia_pages | Reindex all CMS pages |
algolia:reindex:suggestions | indexer:reindex algolia_suggestions | Reindex all query suggestions |
algolia:reindex:additional_sections | indexer:reindex algolia_additional_sections | Reindex all additional sections |
algolia:reindex:process_queue | indexer:reindex algolia_queue_runner | Process jobs in the indexing queue |
algolia:reindex:delete_products | indexer:reindex algolia_delete_products | Remove inactive products from Algolia indices |
Index manually with the indexing queue
To reindex with the indexing queue enabled, run the queue runner manually or rely on cron to process the queue when your data changes. To add all products to the indexing queue, run:You should only implement this as a troubleshooting activity, not as a regular task.
Indexing Manager
Extension version 3.16.0 introduces the Indexing Manager, which includes a new configuration section and a dedicated page in your store’s Magento Admin for triggering full entity indexing.Configuration
To configure the Indexing Manager, go to Stores > Configuration > Algolia Search > Indexing Manager. Starting with extension version 3.16.0, you can turn off the legacy Magento indexers for full indexing. The extension still uses these indexers for incremental updates triggered by Magento materialized views or individual entity save events.For earlier versions of the extension, Magento indexers handle both full and incremental indexing.
Run a full reindex with the Indexing Manager
To reindex, go to Stores > Indexing Manager.
- At the top, you can select specific Entities and Store(s) for reindexing.
- Below, there’s a list of indices managed by the extension (linked to their Algolia dashboard entry).
Batching optimizer
Version 3.17.0 introduces the batching optimizer, a feature that performs a catalog analysis and provides recommendations about the optimal batching size for indexing.Because product indexing is the most resource-intensive process,
the optimizer bases its recommendation on product records.
Magento catalog scan
This step performs a full scan of your catalog and returns the following:- Expected product index size for your store (based on the configured visibility).
- Percentage of simple products (
simple,virtual,downloadable, andgiftcard). - Percentage of complex products (
configurable,grouped, andbundle).
Representative sample
Based on the values returned by the Magento catalog scan, this step selects a representative product sample. By default, the sample contains 20 products. For example, if your catalog contains 75% simple and 25% complex products, the sample includes 15 simple and 5 complex products. The Algolia AI Search & Discovery extension converts each product into a record and shows the record size in the output. To change the sample size, add-s (--sample-size) to the command, up to 1,000 products.
For example:
Calculate optimal batch count
After the command defines the representative sample, it calculates the following values:- Minimum record size.
- Maximum record size.
- Average record size.
- Estimated maximum batch count, based on a 10 MB limit and the average record size.
- Standard deviation, to show record size volatility.
-m (--margin) parameter to the command.
For example:
Update configuration
At the end of the process, you’re prompted to update the Maximum number of records sent per indexing request setting for your store. If you do update this value, make sure you then clear the Magento cache.These numbers are estimates.
Monitor indexing activity after updating the configuration.
If batches exceed 10 MB,
lower the Maximum number of records sent per indexing request value.
Index products
It’s essential for your business to have exact and up-to-date product data in your search.Run a full reindex
To fully reindex all your products, run:Indexable products
To limit indexed products and reduce indexing operations, Algolia only indexes products that appear in your online store. Algolia only indexes products that are:- Visible, either in the catalog, the search, or both
- Enabled
- Not deleted
- In stock, unless you configure Magento to show out-of-stock products.
Missing products
If search can’t find some products, go to the Algolia dashboard, select the index that contains your products and search there.- If you can find the product, confirm that it has the correct visibility setting. If products are only visible in the catalog, they won’t show up while searching. They only show up on the InstantSearch page (in the category section).
- If you can’t find the product, Algolia doesn’t have it yet. Make sure the product meets the indexing requirements, then reindex it.
Price indexing
When creating product records for the corresponding index, Algolia extracts pricing information from Magento’s core “Product Price” index. The Product Price index must be up-to-date each time the Algolia indexer runs. Review the state of the Product Price index from the Magento Admin or the Magento command line.-
Magento Admin, under System > Index Management

-
Magento command line, identified as
catalog_product_price, by running:bin/magento indexer:status
Searchable attributes
Choose which attributes Algolia searches when users type queries. To edit the searchable attributes list, go to Stores > Configuration > Algolia Search > Products.
Default indexed attributes
The extension indexes the following attributes by default, regardless of your configuration. Not all these attributes are searchable but you can use them for filtering, sorting, ranking, and building the results page.| Attribute | Description |
|---|---|
name | Name |
url | URL |
visibility_search | Visibility in the search |
visibility_catalog | Visibility in the catalog |
categories | Categories, formatted as a tree path |
categories_without_path | Categories, without the tree path |
thumbnail_url | Thumbnail image |
image_url | Main image |
in_stock | Stock availability |
type_id | Type (simple, configurable, bundled, and so on) |
image_url start with /pub
This error can occur when you set pub/ as the document root for your Magento installation.
This setup is common but it can affect how the Algolia AI Search & Discovery extension builds image URLs.
The extension can’t detect your document root, so it assumes the Magento base directory is the root folder.
The best way to handle this problem is to make your server ignore /pub in the URL.
If you can’t change the server configuration,
enable Stores > Configuration > Algolia Search > Advanced > Remove /pub/ from image URLs.
After you change this setting, reindex the catalog.
Product price indexing
From version 3.17.0, theprice attribute isn’t indexed by default.
To opt out of indexing it,
remove price from each of the following:
- Stores > Configuration > Algolia Search > Products > Attributes
- Stores > Configuration > Algolia Search > Products > Ranking
- Stores > Configuration > Algolia Search > InstantSearch Results Page > Facets
- Stores > Configuration > Algolia Search > InstantSearch Results Page > Sorts
Facets
Facets are attributes used to filter search results. Common facets include price, color, categories, and brand. You may need to adjust the facets of the products you sell and how your users search for these products. For each facet, you can specify:- The attribute
- The label: displayed above the filter
- The facet type

Rules are only available on Grow and Premium plans.
How to add numeric attributes as non-castable
To access the configuration page for Algolia in your Magento project, go to Stores > Algolia Search > Credentials and Basic Setup > Advanced in the Magento Admin. From there, add text fields or non-castable attributes under Product numeric textfield attributes to prevent Magento from converting them into numeric fields.
Handle empty attribute values in filters
If a product doesn’t have a value for an attribute, Magento sets the attribute value toNo.
To stop indexing these fallback values, set Index empty value to No for the searchable attributes you want to exclude.
Changing any index setting requires a full reindex of all data.
Sorting strategies
Sorting is only available on the InstantSearch Results page.
By default, the Algolia AI Search & Discovery extension uses the exhaustive sorting strategy with standard replicas,
but you can switch to the relevant sorting strategy using virtual replicas.

- From lowest price to highest price
- From highest price to lowest price
- From newest to oldest
Number of records created
Algolia precomputes part of the sort order during indexing to speed up searches. Each index supports only one sort order, so every additional sort creates another replica index. Standard replicas (default) can increase storage more than virtual replicas. By default, the Algolia AI Search & Discovery extension creates these indices in Magento:- One per store
- One per store per additional sort order (such as by price or by date)
| Sort | Records | Total |
|---|---|---|
| Default sorting | 100×2 | 200 |
| Custom sorting | 100×2×4 | 800 |
| Total records | 1000 |
| Sort | Records | Total |
|---|---|---|
| Default sorting | 100×2 | 200 |
| Pricing sorting | 100×2×2×5 | 2000 |
| Custom sorting | 100×2×2 | 400 |
| Total records | 2600 |

Switch to virtual replicas
Virtual replicas are not available on the Grow plan.

You can enable up to 20 virtual replicas per index.
The Algolia AI Search & Discovery extension informs you if you exceed this limit.
Scoped configuration
The Algolia AI Search & Discovery extension creates a product index for each Algolia-enabled store (or “store view”) in your Magento instance. To keep within the virtual replica limits on an index, use the store view selector to configure your sorting attributes for each store independently. Choose the website or store view where you wish to apply the desired changes. For a website scope, remove the Use Default check mark and configure your sorting attributes accordingly:

Index settings
Configure these product index settings in your store’s Magento Admin:searchableAttributescustomRankingunretrievableAttributesattributesForFacetingmaxValuesPerFacetremoveWordsIfNoResults
algolia_products_index_before_set_settings event provided by the Algolia AI Search & Discovery extension.
For more information, see Custom backend events.
Index from the Magento products grid
Version 3.16.0 introduced new features to the Magento products grid:- You can select products in the grid and reindex them with the Actions drop-down menu in the top-left corner: select Reindex to Algolia.
- You can trigger full product reindexing by clicking Reindex All Products to Algolia in the main toolbar at the top of the page.

Index cache
From version 3.17.0, you can use a local cache to speed up full reindexing by skipping queries that retrieve collection sizes in large catalogs. To enable it, go to System > Tools > Cache Management as Algolia Indexer or run the following from the command line:Index categories
To keep the number of records and indexing operations as low as possible, Algolia only indexes active categories. To show all categories in the Autocomplete menu and InstantSearch Results page, set Show categories that aren’t included in the navigation menu to Yes.
Full reindexing
Searchable attributes
Choose which attributes Algolia searches when users type queries. To update the searchable attributes list, go to Stores > Algolia Search > Categories. In the Categories tab, set each attribute to searchable, retrievable, or ordered. By default, the Algolia AI Search & Discovery extension searches attributes as unordered. Keep this default unless you have a specific reason to change it. For more information, see Configuring searchable attributes the right way.Default searchable category attributes
The Algolia AI Search & Discovery extension indexes the following attributes regardless of your configuration. Not all these attributes are searchable but you can use them to filter, sort, customize ranking, and build the results page.| Attribute | Description |
|---|---|
name | Name |
url | URL |
path | Path (parent categories) |
level | Level in the category tree |
include_in_menu | Visibility in the menu |
_tags | Filled automatically by the Algolia AI Search & Discovery extension |
popularity | Popularity |
product_count | Amount of products |
Index settings
Configure these category index settings in your store’s Magento Admin: Manage additional index settings in the Algolia dashboard. To set default values from Magento, configure this under “Advanced Algolia indices settings”. To change the settings programmatically, you can hook into thealgolia_categories_index_before_set_settings event provided by the Algolia AI Search & Discovery extension.
For more information, see Custom backend events.
Index pages
Set Stores > Algolia Search > Indexing Manager > Enable Pages Index to Yes to index CMS pages and show them in the Autocomplete menu. By default, the Algolia AI Search & Discovery extension indexes all active pages.


Full reindexing
Searchable attributes
You can’t configure the searchable attributes for pages in Magento Admin. You can change them programmatically by hooking into thealgolia_after_create_page_object event.
For more information, see Custom backend events.
Default searchable page attributes
These attributes are always indexed and aren’t all searchable. You can use them for filtering, sorting, custom ranking, and building the search results page. These page attributes are always indexed:| Attribute | Description |
|---|---|
name | Name |
url | URL |
slug | Slug |
content | Content |
Index settings
The following page index settings are always set. You can’t change them from the Algolia AI Search & Discovery extension interface:searchableAttributes:unordered(slug),unordered(name)andunordered(content)attributesToSnippet:content:7
algolia_pages_index_before_set_settings event provided by the extension.
For more information, see Custom Backend Events.
Index with the Magento pages grid
Version 3.16.0 introduced new features to the Magento pages grid:- Users can now select pages in the grid and trigger a reindex for them with the Actions drop-down menu on the top-left corner by selecting Reindex to Algolia.
- Users can now trigger a full pages reindexing by clicking Reindex All Pages to Algolia in the main toolbar on top of the page.

Index suggestions
Magento stores every query, the number of results, and the number of searches in thesearch_query table in the database.
Magento only stores backend searches. As-you-type searches aren’t stored.
To learn more about handling as-you-type searches, see Algolia Query Suggestions.


search_query is also updated,
the queries in this table become more relevant over time.
By default, suggestions aren’t indexed automatically. When enabling the indexing of suggestions, you need to trigger a manual reindex.
Another way to start the indexing of suggestions is by adding a recurring job to the cron table:
Full reindexing
Searchable attributes
You can’t configure searchable attributes for suggestions in Magento Admin. You can change them programmatically by hooking them into thealgolia_after_create_suggestion_object event.
For more information, see Custom backend events.
Default searchable query attributes
These attributes are always indexed and aren’t all searchable. You can use these attributes for filtering, sorting, custom ranking, and building the search results page. These query attributes are always indexed:| Attribute | Description |
|---|---|
query | Value |
number_of_results | Number of results |
popularity | Number of searches |
updated_at | Last update timestamp |
Index settings
The following query suggestion index settings are always set. You can’t change them in Magento Admin:searchableAttributes:unordered(query)customRanking:desc(popularity),desc(number_of_results)typoTolerance:falseattributesToRetrieve:queryremoveWordsIfNoResults:lastWords
algolia_suggestions_index_before_set_settings event provided by the Algolia AI Search & Discovery extension.
For more information, see Custom backend events.
Index additional sections
The Autocomplete menu lets you display other sections from attributes, such as colors and brands.For this feature to work, you must enable the InstantSearch Results Page.

Searchable attributes
Manage additional index settings in the Algolia dashboard. It’s also possible to change the settings programmatically, by hooking into thealgolia_additional_sections_index_before_set_settings event provided by the Algolia AI Search & Discovery extension.
For more information, see Custom Backend Events.
Default searchable attributes
The Algolia AI Search & Discovery extension indexes these attributes by default. Not all are searchable but you can use them to filter, sort, customize ranking, and build the results page. The attributes that are always indexed:| Attribute | Description |
|---|---|
| value | The attributes’ value, for example, Red, XL, Nike. |
Index settings
You can’t change this additional section index settings in the Algolia AI Search & Discovery extension interface. The extension always applies it:searchableAttributes:unordered(value)
algolia_additional_sections_index_before_set_settings event provided by the extension.
For more information, see Custom backend events.
Remove inactive products
To remove products from your Algolia index, use thealgolia_delete_products indexer:
The reindexer doesn’t delete products from your Magento database. Products are only removed from Algolia indices.
Incorrect links
If your store’s Magento URLs include/magento/, enable web server rewrites.
- In Magento Admin, go to Stores > Configuration > General > Web > Search Engine Optimization.
- Set Use Web Server Rewrites to Yes.
- Run a full reindex to apply the change.