# setComponentValue

## Description

Allows users to set a value to a component.

## Input / Parameter

| Name        | Description                            | Input Type  | Default | Options | Required                           |
| ----------- | -------------------------------------- | ----------- | ------- | ------- | ---------------------------------- |
| component   | The name of the component.             | String/Text | -       | -       | Partial (Yes if no 'componentId'.) |
| componentId | The id of the component.               | String/Text | -       | -       | Partial (Yes if no 'component'.)   |
| value       | The value to be set for the component. | String/Text | -       | -       | Yes                                |

**\* Note:** Either component or componentId must have a value in order for this function to work.

## Output

N/A

Note: The component will be updated to show the value that has been set to it.

## Callback

N/A

## Video

## Example

### Steps

In this example we have a button (in blue) that when clicked will change the value of the form input component to say "This is the Input Box!"

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

1. First, we drag a button and a form input onto the canvas.
2. Select the button and under the 'Actions' tab, drag the `setComponentValue` into the flow for the button.

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

3. Under the inspector for this function, select the component whose value you would be changing, which in this example is `InputBox`.
4. Enter the new value to display.

### Result

1. Save and preview your app.
2. Now when you click the button, it will set the component value of InputBox to 'This is the Input Box!'

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

## Links

* See also [`componentValue`](https://docs.emobiq.com/emobiq-client/006-actions-and-visual-logic/action-reference/cordova/app/componentvalue)