---
title: "remove fields conditional · RUAL Documentation"
description: "For each object in the array, removes the configured fields only when the value at match_key equals match_value. Non-matching items pass through unchang…"
canonical: https://docs.rual.nl/block-types/array/array_remove_field_conditional
language: en
---

# remove fields conditional

This block is part of the [`array`](https://docs.rual.nl/block-types/array) group and was last modified in core [`v15.0.0`](https://docs.rual.nl/core-versions/150000).

### Fields Selection Required

This block relies on fields that you selected to perform its data actions. You must manually select the fields you want to use in your flow using the fields selector modal. To access the modal, click the white button on the block.

For each object in the array, removes the configured fields only when the value at match_key equals match_value. Non-matching items pass through unchanged. Original objects are not mutated.

- Array required `array` Array of objects to process.

- Match key required `value` Field path on each item to test (e.g. is_fuzzing).

- Match value `value` String value the field at match_key must equal. Fill exactly one of the match_* pins.

- Match number `number` Number value the field at match_key must equal.

- Match boolean `condition` Boolean value the field at match_key must equal.

- Match date `date` Date value the field at match_key must equal.

- Match object `object` Object value the field at match_key must deep-equal.

- Array `array` Array with the configured fields removed on matching items.

Removes the studio-selected fields only from items whose value at match_key equals the compare value; matching items are DEEP-COPIED first, so the input array and its objects are never mutated. Non-matching and non-object items pass through as-is. The compare value is the first filled pin in the order match_condition, match_number, match_date, match_object, match_value. With no filled match pin, an empty match_key or no fields selected, the array passes through unchanged.

| `strip` |
| --- |
| `scrub` |
| `redact` |
| `conditional` |

A typical wiring for [remove fields conditional](https://docs.rual.nl/block-types/array/array_remove_field_conditional): [with values](https://docs.rual.nl/block-types/array/array_of_values) feeds the `array` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `match_key` pin; the `array` out pin feeds [length](https://docs.rual.nl/block-types/array/array_length).

![Studio canvas example for the remove fields conditional block: typical wiring for remove fields conditional.](https://docs.rual.nl/canvas-examples/array_remove_field_conditional.png)

### Version history

Introduced in [`v15.0.0`](https://docs.rual.nl/core-versions/150000).
