Meilisearch concepts
Index
A collection of documents with shared settings. An index is the equivalent of a table in a relational database. Each index has a unique identifier (uid) and its own configuration for ranking, filtering, and other settings. Learn more about indexes.
Document
A JSON object stored in an index. Documents are the basic unit of data in Meilisearch. Each document contains fields (key-value pairs) and must have a unique primary key. Learn more about documents.Primary key
A unique identifier for each document in an index. Meilisearch uses the primary key to distinguish between documents. If you add a document with an existing primary key, the existing document is replaced. Learn more about primary keys.Field
A key-value pair within a document. For example,"title": "The Great Gatsby" is a field where title is the attribute name and "The Great Gatsby" is the value. Learn more about documents.
API key
A token used to authenticate requests to a Meilisearch instance. Meilisearch uses three types of keys: a master key (used to create other keys), a default admin API key (full API access), and a default search API key (search-only access). Learn more about API keys.Master key
A secret key set at launch that protects your Meilisearch instance. The master key is used to generate the default admin and search API keys. It should never be exposed to end users. Learn more about security.Tenant token
A short-lived token generated from an API key that enforces search rules for multi-tenant applications. Tenant tokens allow you to restrict search results per user without creating separate indexes. Learn more about tenant tokens.Task
An asynchronous operation returned by Meilisearch when processing write requests (adding documents, updating settings, etc.). Tasks have statuses likeenqueued, processing, succeeded, or failed. Learn more about tasks.
Batch
A group of tasks that Meilisearch processes together in a single operation. Meilisearch automatically groups compatible enqueued tasks into batches to improve indexing throughput. For example, multiple document addition tasks targeting the same index may be merged into one batch. Learn more about batches.Ranking rules
An ordered list of criteria Meilisearch uses to sort search results by relevance. Default ranking rules includewords, typo, proximity, attribute, sort, and exactness. Learn more about ranking rules.
Filterable attributes
Document fields configured to support filtering. Only fields explicitly listed as filterable can be used infilter search parameters. Learn more about filtering.
Sortable attributes
Document fields configured to support custom sorting. Only fields explicitly listed as sortable can be used insort search parameters. Learn more about sorting.
Searchable attributes
Document fields that Meilisearch scans when performing a search query. By default, all fields are searchable. Restricting searchable attributes improves relevancy and performance. Learn more about searchable attributes.Displayed attributes
Document fields returned in search results. By default, all fields are displayed. Restricting displayed attributes lets you hide internal fields from search responses. Learn more about displayed attributes.Distinct attribute
A field used to deduplicate search results. When set, Meilisearch returns only one document per unique value of the distinct attribute. Learn more about distinct attribute.Synonyms
Words or phrases configured to be treated as equivalent during search. For example, you can define"phone" and "mobile" as synonyms so a search for either term returns results containing both. Learn more about synonyms.
Stop words
Common words (such as “the”, “a”, “is”) excluded from search queries to improve relevancy and performance. API reference.Typo tolerance
Meilisearch’s built-in ability to return relevant results even when the search query contains typos. You can configure the number of allowed typos and disable typo tolerance for specific attributes or words. Learn more about typo tolerance.Pagination
The mechanism for retrieving search results in smaller chunks. Meilisearch supports offset/limit pagination (for navigating pages with numbered buttons) and estimated total hits, which provides approximate result counts. Learn more about pagination.Facets
Categorized counts of document attribute values returned alongside search results. Facets enable UI elements like filtering sidebars showing how many results exist for each category. Learn more about facets.Geo search
The ability to filter and sort search results based on geographic coordinates (_geo field). Geo search supports filtering by radius (_geoRadius) or bounding box (_geoBoundingBox), and sorting by distance using _geoPoint. Learn more about geo search.
Multi-search
A single API request that performs multiple search queries across one or more indexes. Multi-search reduces network overhead and latency compared to sending individual search requests. Learn more about multi-search.Federated search
A type of multi-search where results from multiple indexes are merged and ranked together into a single list, rather than returned as separate result sets. Learn more about federated search.Dump
A serialized export of your entire Meilisearch instance (documents, settings, API keys, and tasks). Dumps are portable across Meilisearch versions and can be used for migrations. Learn more about dumps.Snapshot
A binary copy of your Meilisearch database at a specific point in time. Snapshots are faster to create and restore than dumps but are not portable across versions. Learn more about snapshots.Embedder
A model or service that generates vector representations (embeddings) of documents and queries for AI-powered search. Meilisearch supports built-in embedders (OpenAI, HuggingFace, Ollama) and custom REST embedders. Learn more about embedders.Auto-embeddings
Meilisearch’s ability to automatically generate vector embeddings from your documents without any external pipeline. When you configure an embedder, Meilisearch generates embeddings at indexing time and at query time, so you never need to manage vectors yourself. Learn more about AI-powered search.Document template
A template that controls how document fields are combined into a single text string before being sent to an embedder for auto-embedding. Templates let you choose which fields matter for semantic search and how they are formatted. For example, a template like"{{ doc.title }}: {{ doc.description }}" tells Meilisearch to embed the title and description together. Learn more about document templates.