---
title: "remove fields · RUAL Documentation"
description: "Removes the specified fields from the objects in this array. Each object is deep-copied first, so the input array and its objects are not mutated."
canonical: https://docs.rual.nl/block-types/array/array_remove_fields
language: en
---

# remove fields

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

### 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.

Removes the specified fields from the objects in this array. Each object is deep-copied first, so the input array and its objects are not mutated.

- Array required `array`

- Array `array`

Returns a new array in which each object item is a deep copy with the studio-selected field paths deleted; the input array and its objects are NOT mutated. Non-object items pass through as-is. An empty or non-array input outputs null; with no fields selected the input passes through unchanged.

A typical wiring for [remove fields](https://docs.rual.nl/block-types/array/array_remove_fields): [search](https://docs.rual.nl/block-types/storage/function_search) feeds the `array` pin; the `array` out pin feeds [filter by geo distance](https://docs.rual.nl/block-types/array/array_filter_geo_distance).

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

### Commonly used with

In production blueprints, this block is most often wired together with:

- [search](https://docs.rual.nl/block-types/storage/function_search): feeds into this block. searches in the given storage based on a query.

- [filter by geo distance](https://docs.rual.nl/block-types/array/array_filter_geo_distance): this block feeds into it. Filters an array of objects, keeping only items where the from location is within the distance specified by each item's distance field. The distance unit (km or m) is configurable.

- [map](https://docs.rual.nl/block-types/array/array_map): this block feeds into it. Creates a new array with the results of the provided function on every element in the array.

- [storage left join document](https://docs.rual.nl/block-types/storage/function_storage_left_join_document): feeds into this block. Left joins documents from a storage into the given array. Looks up each document by its corresponding GUID and nests the found document under the specified key. Documents without a match get null for that key.

- [reply in JSON](https://docs.rual.nl/block-types/json/httpconnection_set_json): this block feeds into it. Reply to any httpconnection as JSON body.

### Version history

Introduced in [`v14.0.4`](https://docs.rual.nl/core-versions/140004).