---
title: "execute · RUAL Documentation"
description: "Executes the given funcion and waits for it to be executed."
canonical: https://docs.rual.nl/block-types/function%20execution/function_custom_execute
language: en
---

[Cluster](https://docs.rual.nl/cluster)

[Blocks](https://docs.rual.nl/block-types)

[Interfaces](https://docs.rual.nl/interfaces)

[Blueprints](https://docs.rual.nl/blueprints)

[Tutorials](https://docs.rual.nl/tutorials)

[Home automation](https://docs.rual.nl/home-automation)

[Examples](https://docs.rual.nl/examples)

[Reference](https://docs.rual.nl/reference)

[Architecture](https://docs.rual.nl/architecture)

[Troubleshooting](https://docs.rual.nl/troubleshooting)

Other

# execute

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

## Function Selection Required

This block requires you to choose a custom function to execute when triggered. You must manually select the function you want to use using the function selector modal. To access the modal, click the white button on the block.

Executes the given funcion and waits for it to be executed.

- flow `flow`

Calls the selected function synchronously and waits for it: every input pin value is passed into the function's trigger, its return values are mapped back onto this block's output pins, and exposed return data lands on exposed_data_output. A failed call sets success=false with the error message; with no function selected the block does nothing and the flow just continues.

| `custom function` |
| --- |

[execute](https://docs.rual.nl/block-types/function%20execution/function_custom_execute) calls the custom function you picked on the block and waits for it to finish. It sits inline in the flow: a [function trigger](https://docs.rual.nl/block-types/globals/trigger_custom_function) starts the caller, execute runs the callee, and the flow continues to [return](https://docs.rual.nl/block-types/function%20execution/function_return) afterwards.

[![Studio canvas example for the execute block: calling another function mid-flow.](https://docs.rual.nl/canvas-examples/function_custom_execute.png)](https://docs.rual.nl/canvas-examples/function_custom_execute.png?v=3)

## Commonly used with

One of the most-used blocks across production blueprints. It is most often wired together with:

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

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

- [get fields](https://docs.rual.nl/block-types/object/object_field_getter_multiple): feeds into this block. Gets the selected fields from the given object.

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

- [get guid](https://docs.rual.nl/block-types/users/user_get_guid): feeds into this block. Returns the guid (field: _meta.guid) of the given user.

- [get document](https://docs.rual.nl/block-types/storage/function_get_document): feeds into this block. get a specific document based on the given GUID.

## Used in these guides

These documentation pages use or explain this block:

- [Best Practices](https://docs.rual.nl/blueprints/best-practices)

- [Tips & tricks](https://docs.rual.nl/blueprints/tips-and-tricks)

- [Build Your First API](https://docs.rual.nl/cluster/api-quickstart)

## Version history

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

- [Back to `function execution`](https://docs.rual.nl/block-types/function%20execution): Return to the main group to view all sub-groups

- [Back to `function`](https://docs.rual.nl/block-types/function%20execution?group=function): Return to the group to view all blocks within this group

Was this page helpful? [Tell us what to improve](https://docs.rual.nl/support) · RUAL Docs is an integral component of the [RUAL ecosystem](https://rual.nl)