# replace

## Description

Locates a specific set of characters in a string of text and substitutes it with something else.

## Input / Parameter

| Name | Description                        | Input Type | Default | Options | Required |
| ---- | ---------------------------------- | ---------- | ------- | ------- | -------- |
| text | The text to be updated.            | Text       | -       | -       | Yes      |
| from | The value to be replaced.          | Text       | -       | -       | Yes      |
| to   | The value to use as a replacement. | Text       | -       | -       | No       |

## Output

| Description               | Output Type |
| ------------------------- | ----------- |
| Returns the updated text. | String/Text |

## Example

In this example, we will attempt to replace the occurrence of a word within a text with another word

### Steps

1. Drag a `button` component into the canvas and open the `Action` tab. Select the `press` event of the button.
2. Add `Log.write` function and add a subflow on its value, then put `Text.replace` inside it. Fill up the parameters accordingly.

   ![](https://399701567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwmJ1RKjM2uNFaL6fO3Xu%2Fuploads%2Fgit-blob-e76ee6b37d0f8e435c12afd7c779b72ab9f14aef%2Freplace-step-1.png?alt=media)

### Result

1. The console on preview will show the changed text after replacement.

   ![](https://399701567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwmJ1RKjM2uNFaL6fO3Xu%2Fuploads%2Fgit-blob-8dc4c329603d635ceec453e9b7ee3a190fce7792%2Freplace-result-1.png?alt=media)

## Links

### Related Information