---
title: catch
page-cloud: true
latest-operator-version: v26.2.6
latest-console-tag: v3.14.0
latest-connect-version: 4.118.0
latest-redpanda-tag: v26.2.7
docname: connect/components/processors/catch
page-component-name: cloud-data-platform
page-version: master
page-component-version: master
page-component-title: Cloud
page-relative-src-path: connect/components/processors/catch.adoc
page-edit-url: https://github.com/redpanda-data/cloud-docs/edit/main/modules/develop/pages/connect/components/processors/catch.adoc
description: Applies a list of child processors _only_ when a previous processing step has failed.
page-self-managed-available: "true"
page-self-managed-available-url: https://docs.redpanda.com/connect/components/processors/catch/
page-git-created-date: "2024-09-09"
page-git-modified-date: "2026-10-22"
page-generated-sources:
  - include: connect:components:partial$descriptions/processors/catch.adoc
    generator: null
    version: null
    source: the component specs in https://github.com/redpanda-data/connect
page-generated-content: partial
---

# catch

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [cloud-data-platform-full.txt](https://docs.redpanda.com/cloud-data-platform-full.txt)

<!-- Source: https://docs.redpanda.com/cloud-data-platform/develop/connect/components/processors/catch.md -->

Applies a list of child processors _only_ when a previous processing step has failed.

Behaves similarly to the [`for_each`](https://docs.redpanda.com/cloud-data-platform/develop/connect/components/processors/for_each/) processor, where a list of child processors are applied to individual messages of a batch. However, processors are only applied to messages that failed a processing step prior to the catch.

For example, with the following config:

```yaml
pipeline:
  processors:
    - resource: foo
    - catch:
      - resource: bar
      - resource: baz
```

If the processor `foo` fails for a particular message, that message will be fed into the processors `bar` and `baz`. Messages that do not fail for the processor `foo` will skip these processors.

When messages leave the catch block their fail flags are cleared. This processor is useful for when it’s possible to recover failed messages, or when special actions (such as logging/metrics) are required before dropping them.

> 📝 **NOTE**
>
> When strict error handling (`error_handling.strict`) is enabled this processor does not recover anything, as a failed message short-circuits past it rather than reaching it. Use the [`try_catch`](https://docs.redpanda.com/cloud-data-platform/develop/connect/components/processors/try_catch/) processor instead, which contains both the fallible step and its recovery.

More information about error handling can be found in [Error handling](https://docs.redpanda.com/cloud-data-platform/develop/connect/configuration/error_handling/).

## Common

```yml
processor:
  label: ""
  catch: []
```

## Advanced

```yml
processor:
  label: ""
  catch: []
```