> ## Documentation Index
> Fetch the complete documentation index at: https://www.meilisearch.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrate Meilisearch Cloud with Vercel

> Link Meilisearch Cloud to a Vercel Project.

In this guide you will learn how to link a [Meilisearch Cloud](https://www.meilisearch.com/cloud?utm_campaign=oss\&utm_source=docs\&utm_medium=vercel-integration) instance to your Vercel project.

## Introducing our tools

### What is Vercel?

[Vercel](https://vercel.com/) is a cloud platform for building and deploying web applications. It works out of the box with most popular web development tools.

### What is Meilisearch Cloud?

[Meilisearch Cloud](https://www.meilisearch.com/cloud?utm_campaign=oss\&utm_source=docs\&utm_medium=vercel-integration) offers a managed search service that is scalable, reliable, and designed to meet the needs of all companies.

## Integrate Meilisearch into your Vercel project

### Create and deploy a Vercel project

From your Vercel dashboard, create a new project. You can create a project from a template, or import a Git repository.

<Frame>
  <img src="https://mintcdn.com/meilisearch-6b28dec2/JZ1wsU7CEWrp9Xec/assets/images/vercel/01.create-new-project-on-vercel-dashboard.png?fit=max&auto=format&n=JZ1wsU7CEWrp9Xec&q=85&s=6e15dd4e0c4e249c51b51fec3055c98c" alt="Create a new project on Vercel dashboard" width="3170" height="2192" data-path="assets/images/vercel/01.create-new-project-on-vercel-dashboard.png" />
</Frame>

Select your project, then click on **Deploy**. Once deployment is complete, go back to your project’s dashboard.

### Add the Meilisearch integration

Go to the project settings tab and click on **Integrations** on the sidebar menu to the left of your screen.

<Frame>
  <img src="https://mintcdn.com/meilisearch-6b28dec2/JZ1wsU7CEWrp9Xec/assets/images/vercel/02.project-settings-integrations-tab.png?fit=max&auto=format&n=JZ1wsU7CEWrp9Xec&q=85&s=5ff5bfb58c214d46d9e4ab4490d51fbc" alt="Selecting the integration tab in the project settings" width="3166" height="2230" data-path="assets/images/vercel/02.project-settings-integrations-tab.png" />
</Frame>

Search for the [Meilisearch integration](https://vercel.com/integrations/meilisearch-cloud) in the search bar. Click on the **Add integration** button.

<Frame>
  <img src="https://mintcdn.com/meilisearch-6b28dec2/JZ1wsU7CEWrp9Xec/assets/images/vercel/03.meilisearch-cloud-integration-page-in-marketplace.png?fit=max&auto=format&n=JZ1wsU7CEWrp9Xec&q=85&s=593d5541a55d2dbf987f9cc8876233c6" alt="Meilisearch integration page in Vercel's marketplace" width="3160" height="1824" data-path="assets/images/vercel/03.meilisearch-cloud-integration-page-in-marketplace.png" />
</Frame>

Select the Vercel account or team and the project you to which you want to add the integration. You may add the Meilisearch integration to one or more projects in this menu.

<Frame>
  <img src="https://mintcdn.com/meilisearch-6b28dec2/JZ1wsU7CEWrp9Xec/assets/images/vercel/04.add-meilisearch-cloud-form.png?fit=max&auto=format&n=JZ1wsU7CEWrp9Xec&q=85&s=97d54737e717596f3ab64d3bc935b8b4" alt="Form to add Meilisearch integration, the 'Specific projects' option is selected" width="3170" height="1824" data-path="assets/images/vercel/04.add-meilisearch-cloud-form.png" />
</Frame>

Click on **Continue**. Vercel will display a list with the permissions the integration needs to work properly. Review it, then click on **Add Integration**.

### Set up Meilisearch Cloud

Vercel will redirect you to the Meilisearch Cloud page. Log in or create an account. New accounts enjoy a 14-day free trial period.

You can choose an existing project or create a new one. To create a new project, complete the form with the project name and region.

<Frame>
  <img src="https://mintcdn.com/meilisearch-6b28dec2/JZ1wsU7CEWrp9Xec/assets/images/vercel/05.create-a-meilisearch-cloud-project-form.png?fit=max&auto=format&n=JZ1wsU7CEWrp9Xec&q=85&s=74a92949b681a05606f6bd6c9ae040c0" alt="Meilisearch Cloud form to create a project complete, with 'search-app' as the project's name and 'Frankfurt' as the region" width="3166" height="1824" data-path="assets/images/vercel/05.create-a-meilisearch-cloud-project-form.png" />
</Frame>

Once you click on **Create project**, you should see the following message: “Your Meilisearch + Vercel integration is one click away from being completed.” Click "Finish the Vercel integration setup". Meilisearch will then redirect you back to the Vercel integration page.

<Frame>
  <img src="https://mintcdn.com/meilisearch-6b28dec2/JZ1wsU7CEWrp9Xec/assets/images/vercel/06.meilisearch-cloud-integration-page-in-vercel-dashboard.png?fit=max&auto=format&n=JZ1wsU7CEWrp9Xec&q=85&s=fdca42c84aa785dc7baa68ba5587066d" alt="Meilisearch integration page in Vercel's dashboard" width="3160" height="1826" data-path="assets/images/vercel/06.meilisearch-cloud-integration-page-in-vercel-dashboard.png" />
</Frame>

### Understand and use Meilisearch API keys

Meilisearch creates [four default API keys](/resources/self_hosting/security/basic_security#obtaining-api-keys): `Default Search API Key`, `Default Admin API Key`, `Default Read-Only Admin API Key`, and `Default Chat API Key`.

#### Admin API key

Use the `Default Admin API Key`, to control who can access or create new documents, indexes, and change index settings. Be careful with the admin key and avoid exposing it in public environments.

#### Search API key

Use the `Default Search API Key` to access the [search route](/reference/api/search/search-with-post). This is the one you want to use in your front end.

The Search and Admin API keys are automatically added to Vercel along with the Meilisearch URL. For more information on the other default keys, consult the [security documentation](/resources/self_hosting/security/basic_security#obtaining-api-keys).

<Tip>
  The master key (which hasn’t been added to Vercel) grants users full control over an instance. You can find it in your project’s overview on your [Meilisearch Cloud dashboard](https://cloud.meilisearch.com/projects/?utm_campaign=oss\&utm_source=docs\&utm_medium=vercel-integration). Read more about [Meilisearch security](/resources/self_hosting/security/master_api_keys).
</Tip>

### Review your project settings

Go back to your project settings and check the new Meilisearch environment variables:

* `MEILISEARCH_ADMIN_KEY`
* `MEILISEARCH_URL`
* `MEILISEARCH_SEARCH_KEY`

<Frame>
  <img src="https://mintcdn.com/meilisearch-6b28dec2/JZ1wsU7CEWrp9Xec/assets/images/vercel/07.project-settings-environment-variables-tab.png?fit=max&auto=format&n=JZ1wsU7CEWrp9Xec&q=85&s=ea05c280602dee85f62c8d8ece4fffcd" alt="Display the environment variables in the project settings" width="3170" height="1826" data-path="assets/images/vercel/07.project-settings-environment-variables-tab.png" />
</Frame>

<Tip>
  When using [Next.js](https://nextjs.org/), ensure you prefix your browser-facing environment variables with `NEXT_PUBLIC_`. This makes them available to the browser side of your application. Be aware that any variable with this prefix is embedded in the client-side JavaScript bundle and visible to end users. Only use `NEXT_PUBLIC_` with the search API key, never with the admin or master key.
</Tip>

## Take advantage of the Meilisearch Cloud dashboard

<Frame>
  <img src="https://mintcdn.com/meilisearch-6b28dec2/JZ1wsU7CEWrp9Xec/assets/images/vercel/08.meilisearch-cloud-dashboard.png?fit=max&auto=format&n=JZ1wsU7CEWrp9Xec&q=85&s=f7e86364e1f4488e9c22b458874ecee1" alt="Meilisearch Cloud dashboard: overview of the 'search-app' project" width="3166" height="1830" data-path="assets/images/vercel/08.meilisearch-cloud-dashboard.png" />
</Frame>

Use the [Meilisearch Cloud dashboard](https://cloud.meilisearch.com/projects/?utm_campaign=oss\&utm_source=docs\&utm_medium=vercel-integration), to index documents and manage your project settings.

## Resources and next steps

Check out the [quick start guide](/resources/self_hosting/getting_started/quick_start#add-documents) for a short introduction on how to use Meilisearch. We also provide many [SDKs and tools](/resources/help/sdks), so you can use Meilisearch in your favorite language or framework.

You are now ready to [start searching](/reference/api/search/search-with-post)!
