﻿---
title: Get started with the Elasticsearch Vector Database project type
description: Create an Elasticsearch Vector Database project on Elastic Cloud Serverless, ingest embeddings, and run your first vector or semantic searches.
url: https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/solutions/vector-database/get-started
products:
  - Elastic Cloud Serverless
  - Elasticsearch Vector Database Serverless
applies_to:
  - Elastic Cloud Serverless: Generally available
---

# Get started with the Elasticsearch Vector Database project type
The Elasticsearch Vector Database project type on Elastic Cloud Serverless is built for AI-powered vector retrieval. Use this guide to create a project, add embeddings, and run similarity or semantic searches from your application.
<note>
  Not sure whether this project type is right for you? Refer to [When to use this project type](/elastic/docs-content/pull/7961/solutions/vector-database#when-to-use-this-project-type).If you're looking for an introduction to the Elastic Stack or the Elasticsearch product, go to [Elastic fundamentals](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/get-started) or [The Elasticsearch data store](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/manage-data/data-store).
</note>

<stepper>
  <step title="Create an {{es}} Vector Database {{serverless-short}} project">
    There are two options to create serverless projects:
    - If you're a new user, [sign up for a free 14-day trial](https://cloud.elastic.co/serverless-registration?onboarding_token=vector). For more information about Elastic Cloud trials, check out [Trial information](/elastic/docs-content/pull/7961/deploy-manage/deploy/elastic-cloud/create-an-organization#general-sign-up-trial-what-is-included-in-my-trial).
    - If you're an existing customer, [log in to Elastic Cloud](https://cloud.elastic.co/login) and do the following:
      1. Select **Create project** from the **Serverless projects** panel.
    2. Select **Next** from the **Vector Database** panel.
    3. Name your project.
    4. Select a cloud provider and region. For available regions, refer to [Regions](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/deploy-manage/deploy/elastic-cloud/regions).
    5. Select **Create project**. It takes a few minutes to create your project.
    6. When the project is ready, select **Continue** to open it (you might need to log in to Elastic Cloud again).

    <note>
      You need the `admin` predefined role or an equivalent custom role to create projects. For more information, refer to [User roles and privileges](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/deploy-manage/users-roles/cloud-organization/user-roles).
    </note>
    After you've created your project, note the Elasticsearch endpoint and API key from the project connection details. You'll use these to index data and run searches. New indices in this project type use [vector index mode](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/elasticsearch/mapping-reference/dense-vector#dense-vector-vectordb-document-mode) automatically.
  </step>

  <step title="(Optional) Follow the in-product setup guides">
    When you create a new Vector Database project, the **Set up your Elasticsearch Vector Database** page includes two guided paths you can follow. Each path walks you through ingest and then search examples, with sample scripts you can run in a client of your choosing or run the examples directly in the Console.The following setup guides are available in Kibana:

    | Guide                                 | When to use                                         | What you do                                                                                     |
    |---------------------------------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------|
    | Generate embeddings from your content | You want Elasticsearch to create embeddings for you | Ingest content into a `semantic_text` field, then run a semantic or hybrid query                |
    | Store your existing embeddings        | You already have vectors from your own model        | Index pre-generated embeddings into a `dense_vector` field, then run a semantic or hybrid query |
    You can also skip the setup guide and continue with the steps below.
  </step>

  <step title="Ingest your data">
    Use the approach that matches how you create embeddings.
    <dropdown title="Generate embeddings from your content">
      You can generate embeddings as part of the ingestion workflow instead of creating them in advance.For text content, the recommended approach is to map the target field as [`semantic_text`](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/elasticsearch/mapping-reference/semantic-text). When you ingest documents, Elasticsearch uses the configured inference endpoint to generate and store embeddings automatically. You can check which models are used by default and learn how to change them in [Configure inference endpoints documentation](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/elasticsearch/mapping-reference/semantic-text-setup-configuration#configure-inference-endpoints).For more control over the inference and ingestion workflow, you can also generate embeddings with an inference processor in an ingest pipeline and store them in a vector field. For more information, see [Semantic search with ELSER](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/solutions/search/semantic-search/semantic-search-elser-ingest-pipelines).To walk through mapping a `semantic_text` field, ingesting sample content, and running a hybrid query, follow the [semantic search quickstart](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/solutions/search/get-started/semantic-search).
    </dropdown>

    <dropdown title="Store your existing embeddings">
      Create an index with a [`dense_vector`](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/elasticsearch/mapping-reference/dense-vector) field, and any other text or metadata fields you might need, then index your pre-generated vectors.To walk through indexing sample embeddings and running a kNN search, follow [Bring your own dense vectors to Elasticsearch](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/solutions/search/vector/bring-own-vectors).
    </dropdown>
    Use a language [client](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/reference/elasticsearch-clients) or the [Bulk](https://www.elastic.co/docs/api/doc/elasticsearch-serverless/operation/operation-bulk) API to load data. If you're not ready to use your own content, follow the [semantic search quickstart](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/solutions/search/get-started/semantic-search).
  </step>

  <step title="Search your data">
    Match your query to the vector field type in your mapping. For details on which queries each field type supports, see [Field types and queries](/elastic/docs-content/pull/7961/solutions/search/vector#vector-queries-and-field-types).To walk through common patterns, refer to the following pages:
    - [kNN search in Elasticsearch](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/solutions/search/vector/knn)
    - [Hybrid search](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/solutions/search/hybrid-search)
    For more query options, see [Querying for search](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/solutions/search/querying-for-search) and the [Elasticsearch Serverless API documentation](https://www.elastic.co/docs/api/doc/elasticsearch-serverless/).
  </step>
</stepper>


## Next steps

After you've learned how to ingest embeddings and return relevant results, dig deeper into how vector search works, improve ranking for your use case, and tune project settings for latency and cost. Review the following:
- [Vector search in Elasticsearch](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/solutions/search/vector): Concepts, field types, quantization, and query options
- [Ranking and reranking](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/solutions/search/ranking): Improve relevance after you have a baseline
- [RAG](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/solutions/search/rag): Patterns for grounding LLMs on retrieved context
- [Vector search use cases](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/solutions/search/vector/vector-search-use-cases): RAG, recommendations, multimodal search, and more
- [Search Power](/elastic/docs-content/pull/7961/deploy-manage/deploy/elastic-cloud/project-settings#elasticsearch-manage-project-search-power-settings) and [billing dimensions](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/deploy-manage/cloud-organization/billing/vector-database-billing-dimensions): Balance latency and cost for your project
- [Elasticsearch Vector Database overview](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/solutions/vector-database): When to choose this project type versus the general-purpose Elasticsearch project
- [Elasticsearch solution](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7961/solutions/elasticsearch-solution-project): General-purpose project type and search application UI tools