---
title: "rename · RUAL Documentation"
description: "Renames the given files."
canonical: https://docs.rual.nl/block-types/files/file_rename
language: en
---

# rename

This block is part of the [`files`](https://docs.rual.nl/block-types/files) group and was last modified in core [`v10.4.28`](https://docs.rual.nl/core-versions/100428).

Renames the given files.

- flow `flow`

- files required `file`

- name required `value`

- flow `flow`

- success `condition`

- error `value`

- files `file`

A typical wiring for [rename](https://docs.rual.nl/block-types/files/file_rename): [branch](https://docs.rual.nl/block-types/flow/branch) feeds the `flow` pin; [resize](https://docs.rual.nl/block-types/files/function_resize_image) feeds the `file` pin; [move to public](https://docs.rual.nl/block-types/files/file_move_public) feeds the `value` pin; the `flow` out pin feeds [branch](https://docs.rual.nl/block-types/flow/branch); the `value` out pin feeds [move to public](https://docs.rual.nl/block-types/files/file_move_public).

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

### Commonly used with

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

- [branch](https://docs.rual.nl/block-types/flow/branch): wired in both directions with this block.

- [move to public](https://docs.rual.nl/block-types/files/file_move_public): wired in both directions with this block. Moves the given files to a new public destination.

- [resize](https://docs.rual.nl/block-types/files/function_resize_image): feeds into this block. resize given images with new dimensions.

- [get link](https://docs.rual.nl/block-types/files/file_get_link): this block feeds into it. Returns the link of a given file which can be used as a img src. Will only work with public files.

- [set fields](https://docs.rual.nl/block-types/mutations/mutations_set_bp_field_multiple): this block feeds into it. Generates an array of mutations based on the given filled fields.

- [generate guid](https://docs.rual.nl/block-types/value/value_guid): feeds into this block. Generates a unique GUID. When a seed is provided, the GUID is deterministic (same seed always produces the same GUID) — the sha256 of the seed, the same derivation the document blocks apply to their guid_seed pin. Wire this output into verbatim guid pins (get / update / remove) to address seed-created documents. Never wire it into a guid_seed pin: that would hash the already-hashed value again and address a different document — give guid_seed pins the raw seed instead.

### Version history

Introduced in [`v10.4.28`](https://docs.rual.nl/core-versions/100428).