---
title: Elasticsearch DSL
description: The elasticsearch-dsl gem provides a Ruby API for the Elasticsearch Query DSL. The library allows to programmatically build complex search definitions...
url: https://www.elastic.co/elastic/docs-builder/docs/3028/reference/elasticsearch/clients/ruby/dsl
products:
  - Elasticsearch
  - Elasticsearch Client
  - Elasticsearch Ruby Client
---

# Elasticsearch DSL
The [elasticsearch-dsl](https://github.com/elastic/elasticsearch-dsl-ruby) gem provides a Ruby API for the [Elasticsearch Query DSL](https://www.elasticsearch.com/guide/en/elasticsearch/reference/current/query-dsl.html). The library allows to programmatically build complex search definitions for Elasticsearch in Ruby, which are translated to Hashes, and ultimately, JSON, the language of Elasticsearch.
See [the README](https://github.com/elastic/elasticsearch-dsl-ruby#elasticsearchdsl) for more information.