---
title: stack es simulate ingest cli command
description: Simulate data ingestion. Behaviour flags: --dry-run — validate all inputs and exit without performing any action 
url: https://www.elastic.co/elastic/docs-builder/docs/4075/reference/elastic-cli/cli/stack/es/simulate/ingest
applies_to:
  - Elastic Cloud Serverless: Preview
  - Elastic Stack: Preview
---

# stack es simulate ingest cli command
<cli-modifiers>
</cli-modifiers>

```bash
elastic stack es simulate ingest --docs <docs> [options]
```

Simulate data ingestion.
**Behaviour flags:**
`--dry-run` — validate all inputs and exit without performing any action

## Options

<definitions>
  <definition term="--docs string[] required">
    Sample documents to test in the pipeline.
    **Repeatable:** pass `--docs` multiple times to supply more than one value
  </definition>
  <definition term="--pipeline string">
    The pipeline to use as the default pipeline.
    This value can be used to override the default pipeline of the index.
  </definition>
  <definition term="--merge-type enum">
    The mapping merge type if mapping overrides are being provided in mapping_addition.
    The allowed values are one of index or template.
    The index option merges mappings the way they would be merged into an existing index.
    The template option merges mappings the way they would be merged into a template.
    **Values:** index, template
  </definition>
  <definition term="--component-template-substitutions string">
    A map of component template names to substitute component template definition objects.
  </definition>
  <definition term="--index-template-substitutions string">
    A map of index template names to substitute index template definition objects.
  </definition>
  <definition term="--mapping-addition string">
  </definition>
  <definition term="--pipeline-substitutions string">
    Pipelines to test.
    If you don’t specify the `pipeline` request path parameter, this parameter is required.
    If you specify both this and the request path parameter, the API only uses the request path parameter.
  </definition>
  <definition term="--index string">
    The index to simulate ingesting into.
    This value can be overridden by specifying an index on each document.
    If you specify this parameter in the request path, it is used for any documents that do not explicitly specify an index argument.
  </definition>
  <definition term="--error-trace">
    When set to `true` Elasticsearch will include the full stack trace of errors
    when they occur.
  </definition>
  <definition term="--filter-path string">
    Comma-separated list of filters in dot notation which reduce the response
    returned by Elasticsearch.
    **Repeatable:** pass `--filter-path` multiple times to supply more than one value
  </definition>
  <definition term="--human">
    When set to `true` will return statistics in a format suitable for humans.
    For example `"exists_time": "1h"` for humans and
    `"exists_time_in_millis": 3600000` for computers. When disabled the human
    readable values will be omitted. This makes sense for responses being consumed
    only by machines.
  </definition>
  <definition term="--pretty">
    If set to `true` the returned JSON will be "pretty-formatted". Only use
    this option for debugging only.
  </definition>
  <definition term="--input-file string">
    path to a JSON file to use as command input
  </definition>
  <definition term="--dry-run">
    validate all inputs and exit without performing any action (preview changes without applying them)
  </definition>
</definitions>


## Global Options

<definitions>
  <definition term="--json">
    output as JSON
  </definition>
</definitions>