---
title: Keep fields from events
description: The include_fields processor specifies which fields to export if a certain condition is fulfilled. The condition is optional. If it’s missing, the specified...
url: https://www.elastic.co/elastic/docs-builder/docs/2422/reference/beats/metricbeat/include-fields
---

# Keep fields from events
The `include_fields` processor specifies which fields to export if a certain condition is fulfilled. The condition is optional. If it’s missing, the specified fields are always exported. The `@timestamp`, `@metadata` and `type` fields are always exported, even if they are not defined in the `include_fields` list.
```yaml
processors:
  - include_fields:
      when:
        condition
      fields: ["field1", "field2", ...]
```

See [Conditions](/elastic/docs-builder/docs/2422/reference/beats/metricbeat/defining-processors#conditions) for a list of supported conditions.
You can specify multiple `include_fields` processors under the `processors` section.
<note>
  If you define an empty list of fields under `include_fields`, then only the required fields, `@timestamp` and `type`, are exported.
</note>