---
title: "find by extension · RUAL Documentation"
description: "Filters a list of files by extension (e.g. mp4, jpg, png). Separate alternatives with | (e.g. png|jpg|gif). Returns matching files."
canonical: https://docs.rual.nl/block-types/files/file_find_by_extension
language: en
---

# find by extension

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

Filters a list of files by extension (e.g. mp4, jpg, png). Separate alternatives with | (e.g. png|jpg|gif). Returns matching files.

- files required `file` the files to filter

- extension required `value` the extension to filter by (e.g. mp4, jpg, png). Without dot. Separate alternatives with |, e.g. png|jpg|gif.

- matching files `file`

- first match `file`

- count `number`

- found `condition`

| `filter files` |
| --- |
| `get file by type` |
| `find file` |

A typical wiring for [find by extension](https://docs.rual.nl/block-types/files/file_find_by_extension): [value](https://docs.rual.nl/block-types/value/value_default) feeds the `extension` pin; the `matching` out pin feeds [if](https://docs.rual.nl/block-types/files/file_branch); the `found` out pin feeds [branch](https://docs.rual.nl/block-types/flow/branch).

![Studio canvas example for the find by extension block: typical wiring for find by extension.](https://docs.rual.nl/canvas-examples/file_find_by_extension.png)

### Commonly used with

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

- [if](https://docs.rual.nl/block-types/files/file_branch): this block feeds into it. If.. then.. else..

- [create](https://docs.rual.nl/block-types/globals/trigger_custom_function): feeds into this block. Creates a new function that can be executed using the given name.

- [value](https://docs.rual.nl/block-types/value/value_default): feeds into this block. Simply returns the provided value.

- [branch](https://docs.rual.nl/block-types/flow/branch): this block feeds into it.

- [move to public](https://docs.rual.nl/block-types/files/file_move_public): this block feeds into it. Moves the given files to a new public destination.

- [if](https://docs.rual.nl/block-types/value/value_branch): this block feeds into it. Conditional branching for values (if.. then.. else..). Selects which input value is passed through; it does not route flow.

### Version history

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