Skip to main content
The Algolia AI Search & Discovery extension transforms products, categories, and pages from your store into searchable . This process is called indexing. You can index your data through these methods:
  • Automatically with an indexing queue
  • Manually from your store’s Magento Admin
  • Manually on the command line
The extension keeps your data up to date with two indexing mechanisms:
  • 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.
By default, the indexing operations run synchronously, and you must wait until the indexing process finishes before you can continue. This is inconvenient and can have unexpected side effects. Use the indexing queue instead. It processes all indexing operations in the background and helps prevent errors.

Enable Algolia indexing

To enable Algolia indexing, go to Stores > Algolia Search > Indexing Manager > Enable Indexing and select Yes. Screenshot of the 'Enable Algolia indexing' section showing a drop-down menu set to 'Yes' with explanatory text below.

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.
Processing large indices synchronously may trigger PHP timeouts.
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.
Enable the indexing queue for any full reindexing, especially if you have large catalogs.

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:
1

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.
2

Send manual updates

Use the command line to send manual updates to Algolia’s server. For example, to reindex all products:
php path/to/magento/bin/magento algolia:reindex: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:allNot availableReindex all entities
algolia:reindex:productsindexer:reindex algolia_productsReindex all products
algolia:reindex:categoriesindexer:reindex algolia_categoriesReindex all categories
algolia:reindex:pagesindexer:reindex algolia_pagesReindex all CMS pages
algolia:reindex:suggestionsindexer:reindex algolia_suggestionsReindex all query suggestions
algolia:reindex:additional_sectionsindexer:reindex algolia_additional_sectionsReindex all additional sections
algolia:reindex:process_queueindexer:reindex algolia_queue_runnerProcess jobs in the indexing queue
algolia:reindex:delete_productsindexer:reindex algolia_delete_productsRemove 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:
php path/to/magento/bin/magento algolia:reindex:products
PROCESS_FULL_QUEUE=1 php path/to/magento/bin/magento algolia:reindex:process_queue
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.
For full reindexing, run the new commands or use the Indexing Manager to run a full reindex.

Run a full reindex with the Indexing Manager

To reindex, go to Stores > Indexing Manager. Screenshot of the 'Indexing Manager' page with a 'Reindex' button and drop-down menu for 'Stores' and 'Entities', listing indices for Products, Categories, and Pages. This page consists of two sections:
  • 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.
The Maximum number of records sent per indexing request setting controls batch size during indexing. It’s a key configuration to improve your indexing speed. The default is 1000. To change it, in Magento go to Stores > Configuration > Algolia Search > Advanced > Maximum number of records sent per indexing request. The setting estimates the number of product records that fit in a 10 MB batch.
# A recommendation for all stores
php path/to/magento/bin/magento algolia:batching:optimize
# A recommendation for store_id=42
php path/to/magento/bin/magento algolia:batching:optimize 42
After running the command, you should see output like this:
====== Products for store Default Store View ======
Simple Products:  100000 (99.36% of total)
Complex Products: 640 (0.64% of total)
 ============
Total: 100640 products
 ============
Sample (20 products):
 - 925B (sku: product_dynamic_83490)
 - 927B (sku: product_dynamic_55623)
 - 922B (sku: product_dynamic_68051)
 - 928B (sku: product_dynamic_58422)
 - 925B (sku: product_dynamic_91435)
 - 923B (sku: product_dynamic_1291)
 - 920B (sku: product_dynamic_7178)
 - 923B (sku: product_dynamic_51995)
 - 925B (sku: product_dynamic_41909)
 - 917B (sku: product_dynamic_4882)
 - 926B (sku: product_dynamic_107461)
 - 919B (sku: product_dynamic_41446)
 - 927B (sku: product_dynamic_80410)
 - 925B (sku: product_dynamic_65295)
 - 920B (sku: product_dynamic_2577)
 - 924B (sku: product_dynamic_17259)
 - 922B (sku: product_dynamic_94861)
 - 924B (sku: product_dynamic_15753)
 - 922B (sku: product_dynamic_78834)
 - 922B (sku: product_dynamic_60771)
 ============
Min record size             : 917B
Max record size             : 928B
Average record size         : 923B
Estimated Max batch count   : 10834 records
Standard Deviation          : 2.87
Safety margin               : 0.25
 ============
Recommended batch count     : 10825 records

Important: Those numbers are estimates only. Indexing activity should be monitored after making changes to ensure batches are not exceeding the recommended size of 10 MB.
 ============
This will override your "Maximum number of records sent per indexing request" configuration to 10825 for store "Default Store View".

Are you sure wish to proceed? (y/n)
This command runs a Magento catalog scan, takes a representative sample of the catalog, calculates an optimal batch count, and updates the Magento configuration.

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, and giftcard).
  • Percentage of complex products (configurable, grouped, and bundle).

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:
php path/to/magento/bin/magento algolia:batching:optimize -s 50
# or
php path/to/magento/bin/magento algolia:batching:optimize --sample-size=50

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.
The command uses these values to calculate a recommended batch count. It applies a safety margin (0.25 to 3) to keep batches under the 10 MB limit. Change the safety margin by passing a -m (--margin) parameter to the command. For example:
# A higher margin results in a more conservative recommendation.
php path/to/magento/bin/magento algolia:batching:optimize -m 1.5
# or
php path/to/magento/bin/magento algolia:batching:optimize --margin=1.5

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:
php path/to/magento/bin/magento algolia:reindex:products

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.
If you miss a product in your search, make sure the product meets all four criteria. For troubleshooting information, see Troubleshooting data, indexes, and queues

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.
If the problem persists, turn on logging and investigate the log files to see what’s going on during the reindexing process.

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 Screenshot of a table showing indexing jobs, with the 'Product Price' row highlighted, showing 'UPDATE BY SCHEDULE', 'READY', 'IDLE (0 IN BACKLOG)', and updated time 'Dec 18, 2024, 5:41:58 PM'.
  • Magento command line, identified as catalog_product_price, by running: bin/magento indexer:status Verify Product Price index from the Magento command line
If the Product Price index is invalid or is missing records, the Algolia indexer can’t sync the related products. If products are missing on your storefront, even after confirming that they meet the criteria for visibility, this could be the result of missing Product Price index records. For details of how to resolve this issue, see the troubleshooting guide.

Searchable attributes

Choose which attributes Algolia searches when users type queries. To edit the searchable attributes list, go to Stores > Configuration > Algolia Search > Products. Screenshot of the 'Indexing' page showing the 'Searchable attributes' table with 'Attribute', 'Searchable?', 'Ordered?', and 'Retrievable?' columns. In the Products 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 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.
AttributeDescription
nameName
urlURL
visibility_searchVisibility in the search
visibility_catalogVisibility in the catalog
categoriesCategories, formatted as a tree path
categories_without_pathCategories, without the tree path
thumbnail_urlThumbnail image
image_urlMain image
in_stockStock availability
type_idType (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, the price 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
Screenshot of a facet configuration table with attributes 'price', 'color', 'gender', and a drop-down menu showing 'Searchable' selected. Select one of the modifiers from the Options drop-down menu to make facet values searchable, not searchable, or filterable (not “facetable”).
Use the filterOnly modifier if you only want to use the filtering feature. This will help optimize search speed and reduce index size.
You can attach facets to rules. If you set Create Query rule to Yes, Algolia uses the attribute as a filter. Suppose you create a rule for the color attribute and users search for products with a specific color, for example, “red shorts”. In that case, Algolia filters all results with “red” as the color attribute. When you attach a rule to an attribute, the Algolia AI Search & Discovery extensdion applies it to both the Autocomplete menu and the InstantSearch results page.
Rules are only available on Grow and Premium plans.
By default, the extension adds facets for price, categories, and color. For numeric attributes, like price, the UI uses a slider. Attributes specified as facets are automatically indexed as retrievable but not searchable. You don’t need to add them manually to the searchable attributes.

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. Screenshot of a settings page highlighting an instruction to prevent text field attributes from being converted to numbers.

Handle empty attribute values in filters

If a product doesn’t have a value for an attribute, Magento sets the attribute value to No. 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.
When searching for products, users may expect multiple ways to sort the result set. For example, they want to sort by relevance, popularity, price, or date. By default, search results sort by relevance. Define any other sorting strategy in the sort settings. For each strategy, define an attribute, sort order (ascending or descending), and label. You can also specify whether to create a virtual replica (instead of a standard replica) for the sorting strategy. Screenshot of a 'Sorting' table with three sort rules for 'price' and a timestamp attribute, each with 'Sort', 'Label', and 'Enable Virtual Replica?' options. By default, there are three sorting strategies:
  • From lowest price to highest price
  • From highest price to lowest price
  • From newest to oldest
If you’ve chosen to use standard replicas, each sorting strategy creates a new standard replica index, which increases the number of records used by your plan. Attributes configured for sorting are automatically indexed as retrievable but not searchable. You don’t need to add them manually to the searchable attributes. Saving sorting changes in your store’s Magento Admin updates replica indices in Algolia. When you remove a sorting attribute, Algolia deletes the corresponding replica index. If you experience issues with your replica configuration in Algolia or can’t save changes from the Magento Admin, refer to the Troubleshooting guidance.
You can also apply sorting strategies to your InstantSearch results pages with Merchandising Studio. With this method, you can add rules that apply alternative sorting strategies when certain conditions are met.The extension doesn’t manage these indices.

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)
For example, a Magento store has two store views (two languages) and each store view has 100 products. You configure two extra sort orders per store view: price and date. This creates four sort orders:
SortRecordsTotal
Default sorting100×2200
Custom sorting100×2×4800
Total records1000
If the customer group feature is enabled, each customer group will result in an extra index on the pricing sorting. Following the preceding example, but with a total of 5 customer groups:
SortRecordsTotal
Default sorting100×2200
Pricing sorting100×2×2×52000
Custom sorting100×2×2400
Total records2600
The number of indexed records can be lowered by either removing some sorting strategies or by converting them to using virtual replicas. (Virtual replicas do require some additional storage but this is marginal relative to the number of records.) Configure sorts in the extension’s administration panel: Screenshot of a sorting table with three rules for 'price' and 'a timestamp attribute,' showing sort order, labels, and virtual replica settings.

Switch to virtual replicas

Virtual replicas are not available on the Grow plan.
To configure Virtual Replicas for Sorting, go to Stores > Configuration > Algolia Search > InstantSearch Results Page > Sorting. Screenshot of a 'Sorting' table with 'Enable Virtual Replica?' drop-down menu showing 'Yes' and 'No' options. In the grid, enable virtual replicas for each desired attribute by setting Enable Virtual Replica? to Yes. When you switch a sorting attribute to a virtual replica, Algolia deletes the standard replica and creates a virtual replica index in its place. If you reset this value to No, the opposite happens. Virtual replicas slightly increase the primary index’s size (less than 10 MB per million records), but they don’t affect the number of records. For more information, see Standard and virtual replicas.
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: Limit virtual replica configuration by website scope For a store scope, remove the Use Website check mark: Screenshot of a 'Sorting' table with 'Enable Virtual Replica?' drop-down menu showing 'Yes' selected. For more information, see Adobe’s documentation.

Index settings

Configure these product index settings in your store’s Magento Admin:
Any changes in the Algolia dashboard override these settings until you perform a full reindex or make updates to your Algolia configuration from the 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 the 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.
Screenshot of a 'Products' grid with an 'Actions' drop-down menu open, showing options including 'Reindex to Algolia'.

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:
bin/magento cache:enable algolia_indexer
Magento clears this cache automatically when the catalog size changes. To clear it manually, go to System > Tools > Cache Management or run:
bin/magento cache:flush algolia_indexer
To turn off the cache, go to System > Tools > Cache Management or run:
bin/magento cache:disable algolia_indexer

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. Show categories that aren't included in the navigation menu configuration

Full reindexing

php path/to/magento/bin/magento algolia:reindex:categories

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.
AttributeDescription
nameName
urlURL
pathPath (parent categories)
levelLevel in the category tree
include_in_menuVisibility in the menu
_tagsFilled automatically by the Algolia AI Search & Discovery extension
popularityPopularity
product_countAmount of products

Index settings

Configure these category index settings in your store’s Magento Admin:
Any changes in the Algolia dashboard override these settings until you perform a full reindex or make updates to your Algolia configuration from 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 the algolia_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. Screenshot of a settings page showing the 'Enable Pages Index' drop-down menu set to 'Yes' under the 'Indexing' section. You can exclude specific pages, like error pages, so they don’t appear in the search results. Screenshot of a table with 'Excluded Pages' showing a drop-down menu with 'no-route' selected and an 'Add' button. Turn off this indexing of pages in Additional Sections. Screenshot of a form with 'Additional Sections' showing 'Pages' in a drop-down menu, 'Pages' in a label field, '2' in 'Hits per page', and a delete icon.

Full reindexing

php path/to/magento/bin/magento algolia:reindex:pages

Searchable attributes

You can’t configure the searchable attributes for pages in Magento Admin. You can change them programmatically by hooking into the algolia_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:
AttributeDescription
nameName
urlURL
slugSlug
contentContent
The Algolia AI Search & Discovery extension skips records larger than your plan’s limit. In such casse, only the page name remains searchable.

Index settings

The following page index settings are always set. You can’t change them from the Algolia AI Search & Discovery extension interface:
Any changes in the Algolia dashboard override these settings until you perform a full reindex or make updates to your Algolia configuration from Magento Admin.
Manage additional index settings in the Algolia dashboard. To set default values from Magento, configure this under “Advanced Algolia indices settings”. You can also change the settings programmatically, by hooking into the 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.
Screenshot of the 'Pages' grid with an 'Actions' drop-down menu open, showing options like 'Delete,' 'Disable,' 'Enable,' and 'Reindex to Algolia.'

Index suggestions

Magento stores every query, the number of results, and the number of searches in the search_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.
The Algolia AI Search & Discovery extension indexes Magento’s tracked queries and displays them in the Autocomplete menu. In the settings, under Stores > Configuration > Algolia Search > Autocomplete Menu, you can filter relevant queries, for example, by the minimum number of results or minimum popularity. To show suggestions, set the Number of queries to greater than 0: Screenshot of a form with 'Number of categories', 'Number of queries', and 'Min query popularity' fields, each with a numeric input and description. Next, enable the creation of the search suggestions index at Stores > Configuration > Algolia Search > Indexing Manager > Enable Query Suggestions Index Screenshot of the 'Enable Query Suggestions Index' drop-down menu set to 'Yes' in the Algolia configuration settings. With these options enabled, the extension processes backend searches. Since the data in 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:
1 * * * * php path/to/magento/bin/magento algolia:reindex:suggestions
Instead of Magento suggestions, you can also use Algolia’s Query Suggestions feature. For more information, see Algolia Query Suggestions.

Full reindexing

php path/to/magento/bin/magento algolia:reindex:suggestions

Searchable attributes

You can’t configure searchable attributes for suggestions in Magento Admin. You can change them programmatically by hooking them into the algolia_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:
AttributeDescription
queryValue
number_of_resultsNumber of results
popularityNumber of searches
updated_atLast update timestamp

Index settings

The following query suggestion index settings are always set. You can’t change them in Magento Admin:
Any changes in the Algolia dashboard override these settings until you perform a full reindex or make updates to your Algolia configuration from the Magento Admin.
Manage additional 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 the 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.
To use additional sections, set the attributes as attributes for faceting. Screenshot of a table with 'Section', 'Label', and 'Hits per page' columns, showing 'Pages' and 'Colors' entries with values 2 and 4, and an 'Add Section' button.
php path/to/magento/bin/magento algolia:reindex:additional_sections

Searchable attributes

Manage additional index settings in the Algolia dashboard. It’s also possible to change the settings programmatically, by hooking into the algolia_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:
AttributeDescription
valueThe 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:
Any changes in the Algolia dashboard override this setting until you perform a full reindex or make updates to your Algolia configuration from the Magento Admin.
Manage additional index settings in the Algolia dashboard. To set default values from Magento, configure this under “Advanced Algolia indices settings”. It’s also possible to change the settings programmatically, by hooking into the 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 the algolia_delete_products indexer:
php path/to/magento/bin/magento algolia:reindex:delete_products
This indexer removes products from Algolia indices that you don’t want to include in search. This helps if you delete or deactivate products directly in Magento’s database and need to remove them from Algolia.
The reindexer doesn’t delete products from your Magento database. Products are only removed from Algolia indices.
If your store’s Magento URLs include /magento/, enable web server rewrites.
  1. In Magento Admin, go to Stores > Configuration > General > Web > Search Engine Optimization.
  2. Set Use Web Server Rewrites to Yes.
  3. Run a full reindex to apply the change.
Last modified on February 18, 2026