How to add AI-powered search to a React app

🦩 Meilisearch 1.10 release
---------------------------

[![Meilisearch 1.10 release notes](https://unable-actionable-car.media.strapiapp.com/meilisearch_1_10_2b7000d5bd.jpg)](/blog/meilisearch-1-10/?utm_campaign=newsletter&utm_source=blog&utm_medium=august-24-updates)

Meilisearch 1.10 introduces federated search and new language settings, and paves the way for AI-powered search stabilization.

[Read release notes](/blog/meilisearch-1-10/?utm_campaign=newsletter&utm_source=blog&utm_medium=august-24-updates)

🚀 Meilisearch Next.js project starter
--------------------------------------

[![Developer Terminal with code: npx create-next-app -e with-meilisearch my-app](https://unable-actionable-car.media.strapiapp.com/GV_6_J_Ld_W_Ws_A_Ar6_Cd_3723955f2a.jpeg)](https://github.com/vercel/next.js/tree/canary/examples/with-meilisearch)

Integrating Meilisearch in a Next.js application just got much easier. Use the create-next-app CLI to scaffold a Meilisearch example in your new Next.js application.

[Learn more](https://github.com/vercel/next.js/tree/canary/examples/with-meilisearch?utm_campaign=newsletter&utm_source=blog&utm_medium=august-24-updates)

🛍️ Shopify storefront guide for Next.js
----------------------------------------

[![Build your Shopify storefront with Next.js and Blazity](https://unable-actionable-car.media.strapiapp.com/blazity_guide_14d74d3924.jpg)](/blog/next-js-shopify-storefront-with-blazity/utm_campaign=newsletter&utm_source=blog&utm_medium=august-24-updates)

Learn to build a Shopify storefront with Next.js and the Blazity commerce starter, using Meilisearch hybrid search to serve all front-end data.

[Read guide](/blog/next-js-shopify-storefront-with-blazity/utm_campaign=newsletter&utm_source=blog&utm_medium=august-24-updates)

📰 In the news
--------------

🎮 [Federated search demo](https://saas.meilisearch.com/deals?utm_campaign=newsletter&utm_source=blog&utm_medium=august-24-updates)

See how federated search can power app-wide search in our example CRM.

🐇 [Integrating Meilisearch Indexing with Directus](https://docs.directus.io/blog/integrating-meilisearch-indexing-with-directus.html)

Learn to build a custom Directus hook extension to index your data in Meilisearch.

🍿 [From Hackathon to Success: The Meilisearch Story](https://thebootstrappedfounder.com/kerollmops-from-hackathon-to-success-the-meilisearch-story/)

Listen to Arvid Kahl's interview of Meilisearch's founder and lead developer, Kero.

📢 [RFC: Query Suggestions](https://github.com/orgs/meilisearch/discussions/740)

Join the discussion to help us shape the future of query suggestions in Meilisearch.

📢 [RFC: Improving the search preview](https://github.com/orgs/meilisearch/discussions/766)

We want your feedback: how can we make it easier to test your search settings?

🤗 Made with Meilisearch
------------------------

Discover how Symfony implemented search in their documentation with Meilisearch PHP. This enables developers to search for guides across 30 different versions—more than 12 million words.

[![Symfony's search solution for 12M words of documentation with Meilisearch](https://unable-actionable-car.media.strapiapp.com/image_67e9f20ca0.png)](/blog/symfonys-solution-for-documentation-search/?utm_campaign=newsletter&utm_source=blog&utm_medium=august-24-updates)

[Read case study](/blog/symfonys-solution-for-documentation-search/?utm_campaign=newsletter&utm_source=blog&utm_medium=august-24-updates)

_We’re always looking to promote new projects from the community. Post yours in the_ [_#built-with-meilisearch_](https://discord.com/invite/hTD5hU2yWV) _channel!_

🦸‍♀️ We’re hiring!
-------------------

See our open positions:

*   [Senior Full-Stack Software Engineer](https://www.meilisearch.com/careers?utm_campaign=newsletter&utm_source=blog&utm_medium=august-24-updates&utm_content=senior-full-stack-software-engineer)
*   [Founding Sales & Business Developer](https://www.meilisearch.com/careers?utm_campaign=newsletter&utm_source=blog&utm_medium=august-24-updates&utm_content=founding-sales-and-business-developer)

* * *

Stay in the loop of everything Meilisearch by subscribing to our [monthly newsletter](https://dub.sh/meili-newsletter?utm_campaign=newsletter&utm_source=blog&utm_medium=august-24-updates). To learn more about Meilisearch's future and help shape it, take a look at our [roadmap](https://roadmap.meilisearch.com/?utm_campaign=newsletter&utm_source=blog&utm_medium=august-24-updates) and participate in our [Product Discussions](https://github.com/orgs/meilisearch/discussions?ref=blog.meilisearch.com).

For anything else, join our developers community on [Discord](https://discord.meilisearch.com/?utm_campaign=newsletter&utm_source=blog&utm_medium=august-24-updates).

Meilisearch August updates

Today we're announcing Meilisearch v1.10. In this article, we’ll review the most impactful changes. For an exhaustive listing, check out the [changelog](https://github.com/meilisearch/meilisearch/releases/tag/v1.10.0) on GitHub.

<Callout>
  Meilisearch 1.10 is available on [Meilisearch Cloud](https://cloud.meilisearch.com/?utm_campaign=release-v1-10&utm_source=blog), too—upgrade now!
</Callout>

New: federated search
---------------------

We’re excited to announce that [federated search](/blog/what-is-federated-search/?utm_campaign=release-v1-10&utm_source=blog is finally coming to Meilisearch. This feature extends the [multi-search API](https://www.meilisearch.com/docs/reference/api/multi_search?utm_campaign=release-v1-10&utm_source=blog#perform-a-multi-search) to allow you to merge results from multiple queries into a single, unified response. You can now search different indexes and get the most relevant results across the entire dataset, not only the most relevant for each index.

For SaaS platforms that need to search across various types of resources or ecommerce sites with diverse product categories, federated search is a game-changer.

Here is an example payload for making a [federated search request](https://www.meilisearch.com/docs/reference/api/multi_search?utm_campaign=release-v1-10&utm_source=blog#federated-multi-search) against the `movies` and `comics` indexes:

```json
{
  "federation": {
    "offset": 5,
    "limit": 10
  },
  "queries": [
    {
      "q": "Batman",
      "indexUid": "movies"
    },
    {
      "q": "Batman",
      "indexUid": "comics"
    }
  ]
}
```

In this example, the [federated search response](https://www.meilisearch.com/docs/reference/api/multi_search?utm_campaign=release-v1-10&utm_source=blog#response-200-ok-1) will look like this:

```json
{
  "hits": [
    {
      "id": 42,
      "title": "Batman returns",
      "overview": "..",
      "_federation": {
        "indexUid": "movies",
        "queriesPosition": 0
      }
    },
    {
      "comicsId": "batman-killing-joke",
      "description": "..",
      "title": "Batman: the killing joke",
      "_federation": {
        "indexUid": "comics",
        "queriesPosition": 1
      }
    },
 ],
  "processingTimeMs": 0,
  "limit": 2,
  "offset": 0,
  "estimatedTotalHits": 2,
  "semanticHitCount": 0
}
```

### Query weighting

Federated search isn't just about combining results; it's about making those results more meaningful and relevant. Thanks to [query weighting](https://www.meilisearch.com/docs/reference/api/multi_search?utm_campaign=release-v1-10&utm_source=blog#federationoptions), you can prioritize certain queries over others, ensuring that the most important data rises to the top.

The example payload below uses **query weighting** in a federated search to give more importance to documents where the `boosted` field is `true`:

```json
{
  "federation": {},
  "queries": [
    {
      "q": "iphone case",
      "indexUid": "products",
      "filter": "BOOSTED = true",
      "federationOptions": {
        "weight": 3.0
      }
    },
    {
      "q": "iphone case",
      "indexUid": "products"
      // federationOptions.weight defaults to 1
    }
  ]
}
```
<Callout>
  Learn more about [federated search and its use cases](/blog/what-is-federated-search/?utm_campaign=release-v1-10&utm_source=blog)
</Callout>

New: language settings for queries and documents
------------------------------------------------

By default, Meilisearch automatically detects the language used in documents and queries. This comes with some limitations for edge cases. Meilisearch 1.10 introduces new language settings that allow users to manually customize their language preferences.

There are two ways to state the language used in a search:

*   Set the language used in a query
*   Set the language used in a document field

### Setting the search query locale

You can define which language is used in a query in the [search parameters](https://www.meilisearch.com/docs/reference/api/search?utm_campaign=release-v1-10&utm_source=blog#query-locales).

**Example payload for searching with query `locales`:**

```json
{
   "q": "進撃の巨人",
   "locales": ["jpn"]
}
```

### Setting the document attributes’ locales

You can define which language is used in your dataset via the [index settings](https://www.meilisearch.com/docs/reference/api/settings?utm_campaign=release-v1-10&utm_source=blog#localized-attributes).

**Example payload for settings with `localizedAttributes`:**

```json
{
  "localizedAttributes": [
    {
      "locales": ["jpn"], 
      "attributePatterns": ["*_japanese"]
    }
  ]
}
```
<Callout>
  Meilisearch support all [ISO-639-2B](https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes) locales.
</Callout>

Self-hosting: Ubuntu v20 is now required
----------------------------------------

If you’re self-hosting Meilisearch, take note: Meilisearch 1.10 now requires **Ubuntu version 20**. This update ensures compatibility with the latest features and maintains optimal performance and security. We advise reading the documentation on [how to upgrade your Ubuntu release](https://documentation.ubuntu.com/server/how-to/software/upgrade-your-release/).

<Callout>
  This change does not affect [Meilisearch Cloud](https://meilisearch.com/cloud?utm_campaign=release-v1-10&utm_source=blog) users.
</Callout>

Experimental: AI-powered search DX improvements
-----------------------------------------------

### New: custom headers to REST API-based embedders

Meilisearch 1.10 supports sending custom headers to your API-based embedding service. When using the `rest` source for your [embedder settings](https://www.meilisearch.com/docs/reference/api/settings?utm_campaign=release-v1-10&utm_source=blog#embedders-experimental), Meilisearch now accepts an optional `headers` object. These headers will be added to all requests made to the embedder API.

**Example payload for embedder settings:**

```json
{
  "source": "rest",
  "apiKey": "•••••••••••••••••",
  "headers": {
    "Custom-Header": "value"
  }
}
```

### New: quality of life improvements

Additionally, we added some minor changes to make working with Meilisearch AI-powered search API easier:

*   Embedder settings now accept a `url` parameter for OpenAI embedder to access OpenAI through a proxy
*   Embedder settings now accept a `dimensions` parameter for ollama embedder
*   Meilisearch now includes `_vectors` in the response for documents without vectors (only when `retrieveVectors` is enabled)

### ⚠️ Breaking: REST API-based embedders breaking changes

The API for [configuring an embedder based on a REST API](https://www.meilisearch.com/docs/learn/experimental/vector_search?utm_campaign=release-v1-10&utm_source=blog#generate-vector-embeddings) (e.g., OpenAI, Mistral, etc.) has quickly evolved and to avoid confusion, we have decided to reorganize the parameters in dedicated `request` and `response` fields.

In practice, this change:

*   removes `query` , `inputField`, `inputType`, `pathToEmbeddings` and `embeddingObject` fields
*   adds `request` and `response` fields

Take a look at the example below to learn how to migrate to the new syntax.

**Before** — With Meilisearch 1.9

```json
{
   "source": "rest",
   "url": "https://localhost:10006",
   "query": {
     "model": "minillm",
   },
   "inputField": ["prompt"],
   "inputType": "text",
   "embeddingObject": ["embedding"]
}
```

**After** — Starting with Meilisearch 1.10

```json
{
   "source": "rest",
   "url": "https://localhost:10006",
   "request": {
     "model": "minillm",
     "prompt": "{{text}}"
   },
   "response": {
     "embedding": "{{embedding}}"
   }
}
```

#### Upgrade procedure

This procedure is only necessary if you're using REST API-based embedder. To upgrade to Meilisearch 1.10, follow these steps:

1.  Remove embedders with source `"rest"`
2.  Update your [Meilisearch Cloud project](https://www.meilisearch.com/docs/learn/update_and_migration/updating?utm_campaign=release-v1-10&utm_source=blog#updating-meilisearch-cloud) or [self-hosted Meilisearch instance](https://www.meilisearch.com/docs/learn/update_and_migration/updating?utm_campaign=release-v1-10&utm_source=blog#updating-a-self-hosted-meilisearch-instance) as usual

Experimental: `CONTAINS` filter operator
----------------------------------------

Meilisearch 1.10 introduces the `CONTAINS` operator. This is still in the experimental stage due to some performance issues we’re working to resolve. This new [filter operator](https://www.meilisearch.com/docs/learn/filtering_and_sorting/filter_expression_reference?utm_campaign=release-v1-10&utm_source=blog#contains) allows to check if a substring is included in a larger string.

Given the document `{ id: 1, name: "Keffir" }`, you can use the filter as follows:

*   `name CONTAINS kef` — search will match the document
*   `name CONTAINS clifford` — search will not match the document

<Callout>
  Remember all filters used lowercase, normalized strings (all accents are removed).
</Callout><Callout>
  Share your feedback via this [Github discussion](https://github.com/orgs/meilisearch/discussions/763).
</Callout>

Experimental: update documents with a function
----------------------------------------------

Meilisearch 1.10 allows you to edit documents by executing [a Rhai function](https://rhai.rs/). This allows you to update only a part of your dataset using filters. Additionally, using a function allows you to implement dynamic logic based on your documents’ data.

The following payload updates the title of all documents with `id` above 3000:

```json
{
  "filter": "id > 3000",
  "function": "doc.title = `✨ ${doc.title.to_upper()} ✨`"
}
```

This also enables more complex use cases, like [implementing a decaying ranking strategy](https://felx.me/2021/08/29/improving-the-hacker-news-ranking-algorithm.html). Depending on your needs, you might implement a function such as the following that will be run regularly by a Cron job.

```json
{
  "context": { "now": 1715423249 },
  "function": "
    // `posted_at` and `now` are Unix Epoch timestamps in seconds
    // they must be converted to hours.
    let age_hours = (context.now - doc.posted_at) / 60 / 60;
    doc.ranking_score = doc.upvotes ** 0.8 / (age_hours + 2) ** 1.8;
  "
}
```
<Callout>
  Share your feedback via this [Github discussion](https://github.com/orgs/meilisearch/discussions/762).
</Callout>

* * *

And that’s a wrap for v1.10! These release notes only highlights the most significant updates. For an exhaustive listing, read the [changelog](https://github.com/meilisearch/meilisearch/releases/tag/v1.10.0) on Github.

Upgrade with ease using Meilisearch Cloud.

[Open Meilisearch Cloud](https://cloud.meilisearch.com/login?utm_campaign=release-v1-10&utm_source=blog)

* * *

Contributors shout-out
----------------------

This release wouldn’t be possible without [Meilisearch](https://github.com/meilisearch/meilisearch) and [Charabia](https://github.com/meilisearch/charabia) contributors [@Karribalu](https://github.com/Karribalu), [@hanbings](https://github.com/hanbings), [@junhochoi](https://github.com/hunhochoi), [@JWSong](https://github.com/JWSong), [@PeterDaveHello](https://github.com/PeterDaveHello), [@LukasKalbertodt](https://github.com/LukasKalbertodt), and [@phillitrOSU](https://github.com/phillitrOSU).

We also want to extend special thanks to our SDK maintainers working hard to make Meilisearch available across many [languages and frameworks](https://www.meilisearch.com/docs/learn/what_is_meilisearch/sdks). We’re excited for [@Sherlouk](https://github.com/Sherlouk) and [@Ja7ad](https://github.com/Ja7ad) to join our open-source maintainers. 💪

* * *

Stay in the loop of everything Meilisearch by subscribing to our [monthly newsletter](https://dub.sh/meili-newsletter?utm_campaign=release-v1-10&utm_source=blog). To learn more about Meilisearch's future and help shape it, take a look at our [roadmap](https://roadmap.meilisearch.com/?utm_campaign=release-v1-10&utm_source=blog) and participate in our [Product Discussions](https://github.com/orgs/meilisearch/discussions).

For anything else, join our developers community on [Discord](https://discord.meilisearch.com/?utm_campaign=release-v1-10&utm_source=blog).

Meilisearch 1.10

Meilisearch is too slow

This guide will walk you through setting up a Next.js storefront for your Shopify commerce. We will use the open-source [Enterprise Ecommerce](https://github.com/Blazity/enterprise-commerce) starter developed by [Blazity](https://blazity.com/) which comes with a CLI to get started in a snap.

Overview
--------

The diagram below gives an overview of the architecture of our application.

![Architecture of an application developed with Enterprise Ecommerce start](https://unable-actionable-car.media.strapiapp.com/blazity_commerce_architecture_0a30272f59.png)

The application stack is composed of 4 key components:

*   **Data sources** — Shopify admin, personalization tools, etc.
*   **Search engine** — Meilisearch
*   **Full-stack app** — Next.js application
*   **Third-party integrations** — Analytics, CRM, etc.

In this architecture, the Meilisearch database aggregates data from multiple sources to make it accessible by the Next.js application.

Our final application will look like this: [live preview](https://commerce.blazity.com/) ✨

Prerequisites
-------------

This guide requires:

*   [Node.js](https://nodejs.org/en/download/package-manager) ≥ 20.x
*   [Yarn](https://yarnpkg.com/getting-started/install) ≥ 4.x
*   [Meilisearch](https://www.meilisearch.com/cloud?utm_campaign=blazity&utm_source=blog&utm_medium=shopify-nextjs-guide) ≥ 1.8
*   A [Shopify](https://www.shopify.com/) store

Setup
-----

This setup phase provides you with the necessary credentials for your application to interact with Meilisearch and your Shopify store.

These credentials match an environment variable that will be needed during the installation phase. For clarity, this guide will indicate with a "✅" emoji each of these variables.

<Callout>
  Thanks to Blazity for the instructions. If you’re running into issues, please consult the [Blazity documentation](https://docs.commerce.blazity.com/).
</Callout>

### Creating a Shopify store

If you don’t have one already, go to [Shopify](https://www.shopify.com/) and create a new store. Shopify associates a unique ID with each store named the _store domain_.

To find your Shopify store domain, go to _Settings_ > _Domains_ . Your store domain looks like this: `your-domain.myshopify.com`.

✅ `Shopify store domain`

### Installing Shopify Headless

In the Shopify Marketplace, find the [Headless application](https://apps.shopify.com/headless) and install it. After installation, click on _Create storefront_.

Then, we will update the API access. In the _Manage API access_ section, click on _Manage_ next to _Storefront API_.

Edit the Storefront API permissions to add the following:

*   `unauthenticated_read_product_inventory`
*   `unauthenticated_read_customer_tags`

After saving the permissions, you can copy the **private access token**.

✅ `Shopify app Storefront API Token`

### Creating a Shopify App

Now, we will create a Shopify App for our store. Shopify Apps allow you to build custom integrations for your store. This app will allow us to get API keys to read and manage data in our Shopify store.

To create a Shopify app:

*   Navigate to your store’s Shopify admin dashboard
*   Open the store’s _Settings_ and navigate to the _Apps and sales channels_ tab
*   Click on _Develop apps_
*   If requested, follow the steps to allow custom app development for your store
*   Create an app and enter a name, e.g., “Next.js App”

After creating your app, navigate to the API credentials tab to find your Shopify app’s API key (not the API secret key!)

✅ `Shopify app API key`

### Configuring the Shopify Admin API key

Shopify apps work with a set of two keys:

*   An **admin API key** — to manage the Shopify admin, e.g., to edit your product catalog
*   A **storefront API key** — to read the product catalog, create carts, etc.

We can configure the access scopes for these API keys in your Shopify app’s _Configuration_ tab. In this section, we will enable the required scopes for our Admin API key.

To configure the scopes for the Admin API key, follow these steps:

*   In the _Admin API integration_ section, click on _Configure_
*   Enable the following scopes:
    *   `write_product_listings`
    *   `read_product_listings`
    *   `read_products`
    *   `write_products`
*   Under _Webhook subscriptions_, select the 2024-01 API version
*   Save :)

<Callout>
  The API version might have changed since this guide was published. We recommend checking out the [Blazity documentation](https://docs.commerce.blazity.com/providers#3-private-admin-app).
</Callout>

With our tokens API scopes defined, we can return to the _API credentials_ tab and install our app. Click _Install app_ to generate your API access tokens.

After installing your Shopify app, you will have access to your Admin API access token. For security reasons, this token will only be revealed to you _once_—**make sure to save it**.

✅ `Shopify app Admin API token`

### Creating your Meilisearch database

Meilisearch is an open-source search engine that provides full-text, vector, and hybrid search capabilities. Our Shopify products data will be synced with Meilisearch, enabling the front-end app to get fast, relevant search results for end users.

If you don’t have one, create a [Meilisearch Cloud](https://www.meilisearch.com/cloud?utm_campaign=blazity&utm_source=blog&utm_medium=shopify-nextjs-guide) account. If necessary, you can first learn how to [get started with Meilisearch Cloud](https://www.meilisearch.com/docs/learn/getting_started/cloud_quick_start?utm_campaign=blazity&utm_source=blog&utm_medium=shopify-nextjs-guide).

<Callout>
  Prefer self-hosting? Learn how to [install Meilisearch locally](https://www.meilisearch.com/docs/learn/getting_started/installation?utm_campaign=blazity&utm_source=blog&utm_medium=shopify-nextjs-guide).
</Callout>

First, create a new _Project_, e.g., Shopify store. This will create a new Meilisearch database and should take a few seconds to complete.

Then, you can navigate to your project’s Settings page to find your _Database URL_ (your host) and _Default Admin API Key_.

✅ `Meilisearch host URL`

✅ `Meilisearch API token`

<Callout>
  We recommend enabling [analytics & monitoring](https://www.meilisearch.com/docs/learn/analytics/analytics?utm_campaign=blazity&utm_source=blog&utm_medium=shopify-nextjs-guide) at this step, so you don’t need to change host later.
</Callout>

### Configuring your Meilisearch

After creating your database, we will create the indexes. You can choose any names for them, but you’ll have to configure your environment variables accordingly. Let’s create two indexes:

*   An index for our products, e.g., `products`
*   An index for our product categories, e.g., `categories`

✅ `Meilisearch Products Index Name`

✅ `Meilisearch Categories Index Name`

With our indexes created, we can now configure them. Meilisearch defaults will work well for most settings. For each index, we will only configure the filterable attributes and sortable attributes.

**Product index** — Filterable attributes

```json
[
	"collections",
	"collections.handle",
	"collections.id",
	"flatOptions",
	"handle",
	"minPrice",
	"tags",
	"variants.availableForSale",
	"vendor",
	"hierarchicalCategories",
	"hierarchicalCategories.lvl0",
	"hierarchicalCategories.lvl1",
	"hierarchicalCategories.lvl2",
	"avgRating"
]
```

**Product index** — Sortable attributes

```json
[
	"minPrice",
	"updatedAtTimestamp",
	"avgRating"
]
```

**Categories index** — Filterable attributes

```json
[
	"handle",
	"id"
]
```

You can leave all other attribute settings to their default value.

Installation
------------

With all credentials in hand, we’re ready to launch the installation wizard. Let’s create our project using Blazity’s `commerce` CLI.

```bash
# with NPM
npm create commerce

# with Yarn
yarn create commerce
```

The first prompt will ask you to select the services to enable. For this guide, we’ll only enable the defaults: Shopify and Meilisearch.

Then, the CLI will ask for a series of credentials. If you followed the Setup section, you should already have all the necessary credentials. After providing all the credentials, the CLI will scaffold your project in a new folder.

After creation, navigate to your project directory. Your `apps/web/.env.local` should look like this:

```bash
# apps/web/.env.local

SHOPIFY_STOREFRONT_ACCESS_TOKEN=shpat_a-very-long-token
SHOPIFY_ADMIN_ACCESS_TOKEN=shpat_another-very-long-token
SHOPIFY_STORE_DOMAIN=your-domain.myshopify.com
SHOPIFY_APP_API_SECRET_KEY=a-32-characters-long-api-key
SHOPIFY_HIERARCHICAL_NAV_HANDLE=hierarchical-categories
MEILISEARCH_PRODUCTS_INDEX=products
MEILISEARCH_CATEGORIES_INDEX=categories
MEILISEARCH_ADMIN_KEY=your-meilisearch-admin-api-key
MEILISEARCH_HOST=https://edge.meilisearch.com
LIVE_URL=https://your-domain.myshopify.com
FLAGS_SECRET=randomly-generated-secret
CRON_SECRET=another-randomly-generated-secret
```

Syncing Meilisearch and Shopify
-------------------------------

Blazity provides a CLI for synchronizing the data between your Shopify and Meilisearch. In this section, we will see how to achieve that using `commerce-cli`.

To sync your Shopify data with your Meilisearch, navigate to your project folder and run:

```bash
npx commerce-cli@latest sync
```

This command will pull all the necessary data from your Shopify store and sync it into your Meilisearch database.

<Callout>
  Additionally, the [`commerce-cli` package](https://docs.commerce.blazity.com/features/cli) can assist you in configuring webhooks to keep your Meilisearch in sync at all times.
</Callout>

Starting your app
-----------------

After initializing your application and syncing the data between Shopify and Meilisearch, you are ready to start your application.

To start your application in development mode, run:

```bash
# with NPM
npm run dev

# with Yarn
yarn dev
```

And that’s it! You can visit your application at `http://localhost:3000` 🎉

You can also consult a live example here: [https://commerce.blazity.com/](https://commerce.blazity.com/?ref=blog.meilisearch.com)

Going further
-------------

This guide doesn’t cover all available features in the Blazity template. For more advanced configurations, you can learn how to set up hierarchical categories, implement highly scalable redirects, and more on [Blazity documentation](https://docs.commerce.blazity.com/introduction).

Additionally, here are resources to help you integrate your new Shopify store with Meilisearch and Next.js:

*   [Meilisearch documentation](https://meilisearch.com/docs?utm_campaign=blazity&utm_source=blog&utm_medium=shopify-nextjs-guide)
*   [Next.js documentation](https://nextjs.org/docs)
*   [Integrate Meilisearch Cloud with Vercel](https://www.meilisearch.com/docs/guides/integrations/vercel?utm_campaign=blazity&utm_source=blog&utm_medium=shopify-nextjs-guide)

* * *

Stay in the loop of everything Meilisearch by subscribing to our [monthly newsletter](https://dub.sh/meili-newsletter?utm_campaign=blazity&utm_source=blog&utm_medium=shopify-nextjs-guide). To learn more about Meilisearch's future and help shape it, take a look at our [roadmap](https://roadmap.meilisearch.com/?utm_campaign=blazity&utm_source=blog&utm_medium=shopify-nextjs-guide) and participate in our [product discussions](https://github.com/orgs/meilisearch/discussions).

For anything else, join our developers community on [Discord](https://dub.sh/meili-discord/?utm_campaign=blazity&utm_source=blog&utm_medium=shopify-nextjs-guide).

Build your Next.js Shopify storefront with Blazity

🦎 Releasing Meilisearch 1.9
----------------------------

[![](https://unable-actionable-car.media.strapiapp.com/meilisearch_1_9_d1239d3d00.jpg)](/blog/meilisearch-1-9/?utm_campaign=newsletter&utm_source=blog&utm_medium=july-24-updates)

Meilisearch 1.9 brings **similar documents**, **ranking score threshold**, **grouping by attribute**, and **improved AI-powered search**.

[Discover updates](/blog/meilisearch-1-9/?utm_campaign=newsletter&utm_source=blog&utm_medium=july-24-updates)

⚖️ Algolia comparison
---------------------

![](https://unable-actionable-car.media.strapiapp.com/meilisearch_vs_algolia_cover_5c7691f971.jpg)

We published a **comparison of the key features** between Meilisearch and Algolia to help you choose search engine that fits your needs.

[Read comparison](/blog/meilisearch-vs-algolia/?utm_campaign=newsletter&utm_source=blog&utm_medium=july-24-updates)

📌 Community picks
------------------

### 📢 [RFC: Database synchronization tooling](https://github.com/orgs/meilisearch/discussions/765)

We're collecting feedback on tooling to synchronize Meilisearch with your database.

### 📢 [RFC: Improving the search preview](https://github.com/orgs/meilisearch/discussions/766)

We want to make testing your search easier, and we need your feedback!

### 🎮 [A better way to build Meilisearch filters in TypeScript](https://levelup.gitconnected.com/a-better-way-to-build-meilisearch-filters-d88846c280d1)

Check out the meilisearch-helper package to build filters with a fluent API.

### ⚡️ [Lightning-fast Laravel search with Meilisearch](https://www.youtube.com/watch?v=FY_x9_eX1AQ)

Watch this video to learn how to build full-text search for Laravel with Meilisearch.

### 📽️ [Product live event](/blog/heres-what-you-missed-q2-2024/?utm_campaign=newsletter&utm_source=blog&utm_medium=july-updates-24#check-out-the-recording-of-the-event-for-more-details)

Watch the replay to learn more about our recent releases and what's coming next.

🤗 Made with Meilisearch
------------------------

A community member built [RemoteJobs.org](https://remotejobs.org) and shared it with the Discord community. It's a remote jobs board focussing on quality offers. It is, of course,  powered by Meilisearch. 🎉

[![](https://unable-actionable-car.media.strapiapp.com/Screenshot_2024_08_01_at_18_55_39_59f37af3bf.png)](https://remotejobs.org)

_We’re always looking to promote new projects from the community. Post yours in the_ [_#built-with-meilisearch_](https://discord.meilisearch.com) _channel!_

🦸‍♀️ We're hiring!
-------------------

See our open positions:

*   [Growth Marketing Manager](https://www.meilisearch.com/careers?utm_campaign=newsletter&utm_source=blog&utm_medium=july-updates-24)
*   [Senior Full-Stack Software Engineer](https://www.meilisearch.com/careers?utm_campaign=newsletter&utm_source=blog&utm_medium=july-updates-24)
*   [Founding Sales & Business Developer](https://www.meilisearch.com/careers?utm_campaign=newsletter&utm_source=blog&utm_medium=july-updates-24)

* * *

Get these monthly updates straight to your inbox by subscribing to our [newsletter](https://dub.sh/meili-newsletter?utm_campaign=newsletter&utm_source=blog&utm_medium=july-24-updates). 💌

For more things Meilisearch, join our developers community on [Discord](https://discord.meilisearch.com/?ref=blog.meilisearch.com). You can learn more about the product by checking out the [roadmap](https://roadmap.meilisearch.com/?ref=blog.meilisearch.com) and participating in [product discussions](https://github.com/meilisearch/product/discussions?ref=blog.meilisearch.com).

Until next time!

Meilisearch July updates

Deciding between Algolia and Meilisearch for your search solution? We're here to help! In this article, we'll compare their features, capabilities, pricing models, and overall strengths and weaknesses.

What is Algolia?
----------------

Founded in 2012, Algolia is a hosted search engine that provides full-text and AI-powered search capabilities. It offers an API that integrates fast, customizable search experiences into websites and mobile applications.

Algolia is known for its remarkable speed and scalability, making it a go-to choice for enterprises looking for sophisticated search functionalities. However, these premium features come with a higher cost, Algolia tends to be more suitable for larger businesses with bigger budgets.

What is Meilisearch?
--------------------

Launched in 2018, [Meilisearch](https://meilisearch.com/?utm_campaign=comparisons&utm_source=blog&utm_medium=vs-algolia) is an open-source search engine that features full-text and AI-powered search capabilities Designed to be developer-friendly and plug-and-play, it addresses most common use cases straight out of the box. Built with Rust, it ensures exceptional performance, security, and flexibility.

Known for its lightning-fast search speeds and modern development environment, Meilisearch is an excellent choice for small-to-medium growing businesses seeking high-performance search functionalities.

Unlike Algolia, Meilisearch is [open-source](https://github.com/meilisearch/meilisearch). You can self-host it or use the [managed Meilisearch Cloud service](https://meilisearch.com/cloud?utm_campaign=comparisons&utm_source=blog&utm_medium=vs-algolia), allowing for flexibility and cost-efficiency.

Algolia vs Meilisearch - Key features compared
----------------------------------------------

### Developer experience

Algolia and Meilisearch both prioritize ease of use, offering straightforward setup processes and comprehensive documentation. These search engines work out-of-the-box, providing great relevancy in most cases without the need for additional configurations. They feature intuitive REST APIs and place a strong emphasis on the developer experience. Meilisearch's open-source nature is a significant asset, as it enables better feedback collection and faster implementations.

When comparing Meilisearch Cloud and Algolia dashboards, Algolia’s interface stands out for its advanced and comprehensive UI. This is understandable, given that Algolia is a fully-hosted search engine that has been in the market for over a decade. In contrast, Meilisearch, which launched its cloud offering much more recently, is still developing its dashboard.

Overall, the Algolia dashboard feels more beginner-friendly and integrated, guiding users smoothly from data addition to frontend integration. Meilisearch, on the other hand, partially relies on its [documentation](https://www.meilisearch.com/docs/learn/getting_started/cloud_quick_start?utm_campaign=comparisons&utm_source=blog&utm_medium=vs-algolia) to guide users through the process. However, it’s important to note that Meilisearch’s dashboard is continually evolving based on user feedback, showing significant potential for improvement.

### SDKs and integrations

Both Algolia and Meilisearch provide [API clients](https://www.meilisearch.com/docs/learn/what_is_meilisearch/sdks?utm_campaign=comparisons&utm_source=blog&utm_medium=vs-algolia) for a variety of popular programming languages, including JavaScript, .NET, Python, PHP, and more, ensuring developers can easily integrate search functionalities into their applications.

Algolia offers a significantly broader selection of SDKs and integrations, particularly in the realm of specialized e-commerce platforms such as Shopify and Adobe Commerce (formerly Magento). This extensive range of integrations makes Algolia a versatile choice for businesses with specific platform requirements.

### Relevance and typo tolerance

Meilisearch and Algolia both deliver excellent relevancy and typo tolerance right out of the box, with options for customization to fine-tune search results. They offer similar features, including synonyms, deduplication, sorting, filtering, faceting, and geosearch.

However, configuring some of these features in Meilisearch can feel more straightforward. Certain functionalities, such as [sorting](https://www.meilisearch.com/docs/learn/fine_tuning_results/sorting#sorting?utm_campaign=comparisons&utm_source=blog&utm_medium=vs-algolia), require fewer configuration steps compared to Algolia. This simplicity makes Meilisearch an attractive option for developers looking for ease of setup and use.

Moreover, unlike Algolia, Meilisearch does not require replicating or copying indexes for each sort criterion, making cost management much more manageable and fair for customers.

Algolia, on the other hand, provides a more extensive feature set with advanced configuration options. Features like filter weighting offer more customization, but this can also add complexity. While Algolia's features can sometimes offer more advanced configuration, Meilisearch is rapidly closing the gap, [regularly launching new features](https://github.com/meilisearch/meilisearch/releases?utm_campaign=comparisons&utm_source=blog&utm_medium=vs-algolia) that enhance its capabilities.

### AI-powered search

Both Algolia and Meilisearch offer advanced semantic search capabilities, but with notable differences in accessibility and customization.

Algolia provides NeuralSearch, its approach to hybrid search, which combines neural search and full-text search results. Algolia leverages AI at multiple levels, including search, ranking, and query suggestions. This feature allows you to choose between keyword search and neural search modes. When using Algolia, text embedding is managed by their proprietary model, which is automatically applied to the documents. However, NeuralSearch is not widely available; it is reserved for the highest plan (Elevate) and requires event data from the front end. In practice, many users have yet to see a running instance of NeuralSearch. 

Meilisearch, on the other hand, offers a more customizable [AI-powered search](https://www.meilisearch.com/solutions/vector-search?utm_campaign=comparisons&utm_source=blog&utm_medium=vs-algolia) experience. It uses state-of-the-art large language model (LLM) providers such as OpenAI and HuggingFace to generate vector embeddings. Additionally, Meilisearch allows you to configure multiple embedders for an index and supports custom embeddings, ensuring flexibility and adaptability. Its [hybrid search](https://www.meilisearch.com/solutions/hybrid-search?utm_campaign=comparisons&utm_source=blog&utm_medium=vs-algolia) approach is highly customizable, enabling you to adjust the semantic ratio for each hybrid search query, ranging [from full semantic to full-text search](/blog/full-text-search-vs-vector-search/?utm_campaign=comparisons&utm_source=blog&utm_medium=vs-algolia Meilisearch's AI-powered search is available both when self-hosting and on Meilisearch Cloud, making it accessible to a wide range of users.

### Analytics & data visualization

Both Meilisearch and Algolia provide robust analytics and data visualization tools to help you monitor and optimize search performance, but they offer these insights in slightly different ways.

Meilisearch offers a [comprehensive set of analytics](https://www.meilisearch.com/docs/learn/cloud/analytics?utm_campaign=comparisons&utm_source=blog&utm_medium=vs-algolia), including metrics such as total searches, user activity, and key search effectiveness indicators like no result rate and click-through rate. You can visualize search trends over time and gain insights into user behavior, including the most searched queries and geographic distribution of searches.

Algolia, on the other hand, provides a more extensive suite of analytics and data visualization tools. Its overview dashboard includes similar key metrics like total searches, user activity, and conversion rates. However, Algolia goes further by offering advanced analytics providing deeper insights into popular filter values and top-performing results.

A notable feature that sets Algolia apart is its A/B testing capability. This allows you to compare an index and its replica with different settings, evaluating metrics like click-through rates and conversion rates. 

In summary, while both Meilisearch and Algolia offer essential analytics tools, Algolia includes more detailed and advanced options, including A/B testing, which can be particularly beneficial for optimizing user interactions in ecommerce use cases. Meilisearch focuses on core metrics and delivers a straightforward visualization of search trends and user behavior.

### Community and support

Algolia offers a dedicated Discord community with 507 members, accessible to all users, providing a platform for discussions, questions, and support. For more personalized assistance, email and website support are available starting from the Grow plan. Additionally, Algolia provides Standard and Extended Support options, though pricing is not disclosed and is only available through sales inquiries.

Meilisearch, being an open-source search engine, has fostered a robust community. Its [Discord community](https://discord.meilisearch.com/?utm_campaign=comparisons&utm_source=blog&utm_medium=vs-algolia) boasts 2,441 members, offering a vibrant space for open-source enthusiasts and users to engage, share knowledge, and seek help. For Cloud users, Meilisearch ensures comprehensive support tailored to each plan: the Build plan includes Discord support, the Pro plan offers chat and email support, and the Custom plan provides priority support with dedicated channels. This tiered support structure reflects Meilisearch's commitment to accessible and responsive customer service.

### Pricing and commercial offerings

Algolia offers a mix of free, pay-as-you-go, and custom pricing plans. The Free Plan includes up to 10,000 search requests per month and 1 million records, while the Grow Plan features a clear pay-as-you-go structure with specific costs for additional search requests and records. However, their Premium and Elevate Plans do not have disclosed pricing and require users to request details from sales.  

In contrast, Meilisearch Cloud has fixed monthly pricing for its Build and Pro plans, priced at $30 and $300 per month, respectively, with specified features and resources included. For larger projects, Meilisearch has a Custom Plan that requires a custom quote.

While Meilisearch does not offer a free tier, it starts at a relatively low monthly cost with substantial resources and support. Additionally, it includes a 14-day free trial without requiring a credit card, making it easy for potential users to explore its features. Moreover, Meilisearch being open-source, it can also be [self-hosted for free](https://www.meilisearch.com/docs/learn/getting_started/installation#local-installation?utm_campaign=comparisons&utm_source=blog&utm_medium=vs-algolia).

Although Algolia might save some costs in specific scenarios, its complexity and potential hidden costs can lead to higher expenses in practice. Meilisearch, with its clear and predictable [pricing model](https://www.meilisearch.com/pricing?utm_campaign=comparisons&utm_source=blog&utm_medium=vs-algolia), is often more attractive for businesses that prefer straightforward budgeting and cost transparency.

### Global coverage

Meilisearch Cloud has server regions in major cities such as San Francisco, New York, London, Frankfurt, and Singapore, strategically positioning itself in key commercial hubs across North America, Europe, and Asia. This coverage allows Meilisearch to provide reliable performance and data residency options in these important regions.

Algolia has a much broader network with clusters deployed in 16 regions globally. This extensive coverage spans the US, Europe, Asia, and additional regions like Brazil, Japan, and Australia. Algolia’s expansive network allows for greater flexibility in data localization, enhancing performance and compliance with local regulations.

Looking ahead, Meilisearch plans to expand its reach by adding more server regions to its network. This expansion will broaden its global coverage, further enhancing its service offerings.

Algolia challenges
------------------

Algolia faces several notable challenges, one of which is its high cost. While Algolia does offer a free tier, it is limited, and scaling up can quickly become expensive. Algolia's powerful features are well-suited for large enterprises, but smaller businesses might find these advanced features and the associated costs overwhelming. The lack of transparency for its Premium and Elevate plans further complicates budgeting, as potential customers must engage with the sales team to get detailed pricing information, which can deter smaller businesses that need to understand costs upfront. 

Additionally, fully leveraging Algolia’s extensive features and capabilities often requires significant customization and technical expertise. This can be a barrier for businesses without dedicated technical teams. 

Furthermore, Algolia's reliance on its proprietary models for AI features means users are dependent on Algolia's technology stack. This dependency can limit businesses looking for more flexibility or integration with other AI solutions.

Meilisearch challenges
----------------------

Meilisearch, despite its strengths, also faces its own set of challenges. One notable challenge is the absence of a completely free tier in the managed cloud version, which might deter very small businesses or startups looking to minimize costs. While Meilisearch's pricing is transparent and reasonable, the lack of a free option in the managed cloud version can be a disadvantage compared to competitors like Algolia. However, being open-source, Meilisearch provides a free, self-hosted option that ensures cost savings for those willing to manage their own infrastructure.

While Meilisearch offers essential and robust features, it might lack some of the advanced features and integrations that Algolia provides, particularly for specialized use cases such as advanced e-commerce applications.

When should you consider Algolia over Meilisearch?
--------------------------------------------------

If your business requires sophisticated e-commerce search functionalities, such as merchandising tools, product recommendations, and advanced filtering options, Algolia is currently better equipped to handle these needs. The platform's features are designed to improve product discovery and conversion rates.

For businesses that want to optimize their search configurations through A/B testing, Algolia provides robust tools to compare different search setups. This is especially beneficial in e-commerce, where fine-tuning search performance can significantly impact sales and customer engagement. 

Algolia’s infrastructure is also optimized for global reach, offering high availability and low latency across different regions. If your business operates internationally and requires consistent performance worldwide, Algolia is a strong contender.

In summary, Algolia excels in delivering advanced e-commerce functionalities, comprehensive analytics, and a globally optimized infrastructure. While it may come with higher costs and a steeper learning curve, these features make it particularly suitable for large enterprises and businesses with complex, high-demand search requirements.

When should you consider Meilisearch over Algolia?
--------------------------------------------------

Meilisearch is an excellent choice for businesses that prioritize simplicity, transparency, and flexibility. Its straightforward setup process and developer-friendly design make it ideal for teams seeking a hassle-free implementation. With robust core features that work out of the box, Meilisearch ensures high performance, fast response times, and excellent relevancy without requiring extensive customization or technical expertise.

For organizations that value open-source solutions, Meilisearch is particularly appealing. It benefits from active community contributions and maintenance, fostering a collaborative environment that accelerates innovation. This allows businesses to adapt and extend the search engine according to their specific requirements, providing greater flexibility and control over their search infrastructure.

The open-source model also ensures the search engine remains aligned with user needs, adding a layer of transparency and flexibility. As a result, customers gain better confidence in their ability to shape the product and steer it in the direction they need, enhancing their overall control and adaptability.

Regular updates every two months ensure that Meilisearch users can benefit from the latest advancements and enhancements, keeping the search engine up-to-date with evolving needs and technologies. This continuous improvement cycle makes Meilisearch a strong contender for businesses looking for a dynamic and easy-to-use search solution.

In summary, choose Meilisearch over Algolia if you need a flexible, developer-friendly search engine with transparent pricing and the benefits of an open-source community. Meilisearch’s focus on simplicity, high performance, and continuous innovation makes it a compelling option for businesses of all sizes.

* * *

Learn more about what Meilisearch can bring to your business.

[Talk to a search expert](https://dub.sh/meili-sales?utm_campaign=comparisons&utm_source=blog&utm_medium=vs-algolia)

* * *

Conclusion
----------

Both Algolia and Meilisearch offer robust search solutions with a developer-friendly experience and high performance.

Algolia is particularly strong in the e-commerce space, offering advanced analytics and features tailored to that use case. Its extensive feature set and flexible scalability options make it a great choice for larger enterprises looking for comprehensive search capabilities.

Meilisearch excels with its advanced AI capabilities, fast development cycle, and transparent pricing, making it an excellent choice for tech teams and app builders who want to be efficient and achieve fast ROI while benefiting from a secure, scalable search solution.

If you're considering making the switch, check out our [Migrating from Algolia to Meilisearch](https://www.meilisearch.com/docs/learn/update_and_migration/algolia_migration?utm_campaign=comparisons&utm_source=blog&utm_medium=vs-algolia) guide for a smooth transition.

You can see Meilisearch in action using this online [demo](https://where2watch.meilisearch.com/?utm_campaign=comparisons&utm_source=blog&utm_medium=vs-algolia). Also, feel free to check out its [public roadmap](https://roadmap.meilisearch.com/?ref=blog.meilisearch.com) and [GitHub community](https://github.com/orgs/meilisearch/discussions?ref=blog.meilisearch.com) to see what new and upcoming features you can look forward to.

<Callout intent="tip">

Check out our detailed comparison of the best [Algolia alternatives](https://www.meilisearch.com/blog/algolia-alternatives) in 2025.

</Callout>

Meilisearch vs Algolia

We're excited to unveil Meilisearch v1.9. In this article, we’ll review the most impactful changes. For an exhaustive listing, check out the [changelog](https://github.com/meilisearch/meilisearch/releases/tag/v1.9.0) on GitHub.

<Callout>
  Meilisearch 1.9 is available on [Meilisearch](https://cloud.meilisearch.com/?utm_campaign=release-v1-9&utm_source=blog) Cloud, too—upgrade now!
</Callout>

New: ranking score threshold
----------------------------

Meilisearch 1.9 allows excluding search results with low ranking scores. When using the new `rankingScoreThreshold` option, Meilisearch will not return any documents below the defined threshold.

```bash
curl \
 -X POST 'http://localhost:7700/indexes/movies/search' \
 -H 'Content-Type: application/json' \
 --data-binary '{
    "q": "green ogre living in a swamp",
    "hybrid": { 
	    "semanticRatio": 0.9, 
	    "embedder": "default" 
	},
    "showRankingScore": true,
    "limit": 5,
    "rankingScoreThreshold": 0.2
 }'
```

Using the ranking score threshold when implementing [hybrid search](https://www.meilisearch.com/docs/reference/api/search?utm_campaign=release-v1-9&utm_source=blog#hybrid-search-experimental) removes irrelevant results and allows your [search analytics](https://www.meilisearch.com/docs/learn/analytics/analytics?utm_campaign=release-v1-9&utm_source=blog) to collect the _No search results_ metric properly.

<Callout>
  Excluded results do not count towards `estimatedTotalHits`, `totalHits`, or facet distribution.
</Callout>

New: distinct attribute at search time (group by)
-------------------------------------------------

Meilisearch 1.9 adds the ability to define a [distinct attribute](https://www.meilisearch.com/docs/learn/configuration/distinct?utm_campaign=release-v1-9&utm_source=blog) at search time. Meilisearch will only return one document with the specified attribute value when using the new `distinct` search parameter.

This feature is commonly used in ecommerce applications. Consider a `products` index containing multiple variants of the same product, e.g. `Blue iPhone 15` and `Red iPhone 15` documents that share the same `product_id`. The API call below will return _a single_ iPhone 15:

```bash
curl \
 -X POST 'http://localhost:7700/indexes/products/search' \
 -H 'Content-Type: application/json' \
 --data-binary '{
    "q": "iphone",
    "distinct": "product_id"
 }'
```
<Callout>
  When `distinct` is provided, Meilisearch ignores the index’s [distinct attribute](https://www.meilisearch.com/docs/learn/configuration/distinct?utm_campaign=release-v1-9&utm_source=blog).
</Callout>

New: `frequency` matching strategy
----------------------------------

Meilisearch 1.9 introduces a new [matching strategy](https://www.meilisearch.com/docs/reference/api/search?utm_campaign=release-v1-9&utm_source=blog#matching-strategy) to prioritize results that contain occurrences of the least frequent query terms. When using the `frequency` matching strategy, Meilisearch will deprioritize very common words.

Let’s take the example of the `"the little prince"` query. In our indexed documents, the words `"the"` and `"little"` likely have a lot of occurrences. Consequently, the matching strategy will prioritize documents containing `"prince"` instead.

Experimental: new similar documents API
---------------------------------------

Meilisearch 1.9 introduces a new [AI-powered search](https://www.meilisearch.com/docs/learn/ai-powered-search/getting_started_with_ai_search?utm_campaign=release-v1-9&utm_source=blog) feature that allows searching for documents similar to an existing document.

The following API call searches for documents similar to the document whose [primary key](https://www.meilisearch.com/docs/learn/core_concepts/primary_key?utm_campaign=release-v1-9&utm_source=blog) is `23` in the movies index:

```bash
curl \
  -X POST /indexes/movies/similar
  -H 'Content-Type: application/json' \
  --data-binary '{
    "id": "23",
    "embedder": "default",
  }'
```

Check out the [similar documents API](https://www.meilisearch.com/docs/reference/api/similar?utm_campaign=release-v1-9&utm_source=blog) for more information about additional parameters.

Experimental: avoid re-generating embeddings
--------------------------------------------

When importing a [dump](https://www.meilisearch.com/docs/learn/advanced/dumps?utm_campaign=release-v1-9&utm_source=blog) created with Meilisearch 1.9 or higher, Meilisearch will not re-generate the embeddings. This will avoid unnecessary computing when upgrading your Meilisearch database.

### New: `regenerate` parameter

Additionally, Meilisearch 1.9 introduces a new API to give more fine-grained control over [document embedding generation](https://www.meilisearch.com/docs/learn/ai-powered-search/getting_started_with_ai_search?utm_campaign=release-v1-9&utm_source=blog#generate-vector-embeddings-with-openai). Specifically, it enables embedding generation whenever a document is updated.

The document `_vectors` object now accepts objects in addition to arrays. The provided object accepts a `regenerate` boolean and an optional `embeddings` array.

Consider the example document below with user-provided embeddings:

```json
{
	"id": 42,
	"_vectors": {
		// Embeddings for the `default` embedder
		// Equivalent to `regenerate: true`
		"default": [0.1, 0.2 ],
		// Embeddings for the `text` embedder
		"text": {
			"embeddings": [[0.1, 0.2, 0.3], [0.4, 0.5, 0.6]],
			// Never regenerate embeddings
			"regenerate": false
		},
		"translation": {
			"embeddings": [0.1, 0.2, 0.3, 0.4],
			// Regenerate embeddings when document is updated
			"regenerate": true
		}
	}
}

```

While, in general, you might want to re-generate your embeddings whenever the document is updated, this facilitates migrating from user-provided embeddings to letting Meilisearch handle embedding without incurring unnecessary costs.

Experimental: hybrid search breaking changes
--------------------------------------------

As we move toward [stabilizing AI-powered search features](https://github.com/meilisearch/meilisearch/issues/4733), we introduced minor breaking changes to make the APIs less error-prone.

### Breaking: empty `embeddings` array

Following user feedback that the previous behavior was unexpected and unhelpful, providing an empty `embeddings` array will now tell Meilisearch that the document has no embeddings.

<Callout>
  Before Meilisearch 1.9, an empty `embeddings` array was interpreted as a single embedding of dimension 0.
</Callout>

### Breaking: removed `_vectors` in search results

Starting with Meilisearch 1.9, API responses to [vector search and hybrid search](https://www.meilisearch.com/docs/learn/ai-powered-search/getting_started_with_ai_search?utm_campaign=release-v1-9&utm_source=blog) requests will not include `_vectors` in the response.

However, you can now use the new `retrieveVectors` search parameter if you want API responses to include them:

```bash
curl \
  -X POST 'http://localhost:7700/indexes/movies/search' \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "q": "star wars",
    "retrieveVectors": true
  }'
```

### Breaking: optimizing user-provided `embeddings`

Starting with Meilisearch 1.9, vector embeddings will no longer be stored as-is. Numbers will be cast to floats in canonicalized representation to save storage and optimize performance. Simply put, the vector `[3]` might be stored as `[3.0]`.

Contributors shout-out
----------------------

Thanks to all community members who participated in this release. Shout out to [@gh2k](https://github.com/gh2k), [@writegr](https://github.com/writegr), and [@yudrywet](https://github.com/yudrywet) for their contributions to [Meilisearch](https://github.com/meilisearch/meilisearch) and [@mosuka](https://github.com/mosuka), [@Soham1803](https://github.com/Soham1803), and [@tkhshtsh0917](https://github.com/tkhshtsh0917) for their contributions to [Charabia](https://github.com/meilisearch/charabia).

And, of course, many thanks to our SDK maintainers, thanks to whom Meilisearch is available across many languages. Special thanks to [@the-sinner](https://github.com/the-sinner) and [@norkunas](https://github.com/norkunas). 🫶

* * *

And that’s a wrap for v1.9! This release post highlights the most significant updates. For an exhaustive listing, read the [changelog on Github](https://github.com/meilisearch/meilisearch/releases/tag/v1.9.0).

Stay in the loop of everything Meilisearch by subscribing to our [monthly newsletter](https://dub.sh/meili-newsletter?utm_campaign=release-v1-9&utm_source=blog). To learn more about Meilisearch's future and help shape it, take a look at our [roadmap](https://roadmap.meilisearch.com/?utm_campaign=release-v1-0&utm_source=blog) and participate in our [Product Discussions](https://github.com/orgs/meilisearch/discussions).

For anything else, join our developers community on [Discord](https://discord.meilisearch.com/?utm_campaign=release-v1-9&utm_source=blog).

Meilisearch 1.9

On June 11, 2024, Meilisearch hosted a live event packed with product updates, sneak peeks, and roadmap discussions. If you couldn't make it, here's a quick recap of what went down.

**AI-powered search refresher and new embedders**
-------------------------------------------------

Our product team took the stage to share insights into developing our AI-powered search solution and outlined our vision for providing ready-to-use components for seamless AI-powered search integration. By adding semantic and AI capabilities to Meilisearch's core keyword and full-text product, we introduced a [hybrid search solution](https://www.meilisearch.com/solutions/hybrid-search) in early 2024.

To streamline the developer experience, we have since added [Ollama and REST embedders](/blog/meilisearch-1-8/ for easier integration within the v1.8 scope.

![](https://lh7-us.googleusercontent.com/docsz/AD_4nXd_QlnM1707ZYLjpOrhzxjZrWDxgdVo3TL5Dewz6dM1ZIbhZp4CcPUJdtDhV4xAA_ZZACDSv8h9JF_d2AoFSNGYNlShW_JOI_s1TrqbEtntN-7pvxW8UnTTdVMNml9oBroLhZfrVprM5dQmM0HiTP55MZPw?key=pr3OBspkNUkqXQYoKJ84OA)

You are welcome to try out the hybrid search feature using our [movie demo database](https://where2watch.meilisearch.com/). 

**New relevancy improvements and smarter search**
-------------------------------------------------

We also introduced several new features designed to _improve search relevancy_ in v1.9:

*   **Negative keyword search**: exclude unwanted results easily.
*   **New frequency matching strategy**: enhance search accuracy by removing the most common term found in the dataset.
*   **Filter by score**: set a baseline _rankingScore_ to return only results considered "good enough" in terms of relevancy.
*   **Get similar documents:** utilize AI to find similar documents within your dataset.

This new feature set is slated for launch on July 1st.

**Query suggestions sneak peek**
--------------------------------

Attendees also got a sneak peek into an upcoming release. The new _query suggestions_ feature aims to enhance search efficiency by returning real-time, relevant suggestions as users type, ordered by popularity. This feature leverages [cloud search analytics](/blog/search-analytics-release/ to generate and rank suggestions based on popularity and relevance. Designed for seamless integration, it requires no new endpoints or tools and is expected to be released in Q3. Ongoing improvements will be based on user feedback.

**Check out the recording of the event for more details:**
----------------------------------------------------------

* * *

Get these monthly updates straight to your inbox by subscribing to our [newsletter](https://dub.sh/meili-newsletter).

For more things Meilisearch, join our developers' community on [Discord](https://discord.meilisearch.com/?ref=blog.meilisearch.com). You can learn more about the product by checking out the [roadmap](https://roadmap.meilisearch.com/?ref=blog.meilisearch.com) and participating in [product discussions](https://github.com/meilisearch/product/discussions?ref=blog.meilisearch.com).

Until next time!

Meilisearch latest news and company updates