> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-platform/2023-2/studio/tasks/reference/new-variable/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# newVariable

> Use the newVariable task to create a new job variable of type boolean, number, string, object, or array.

The `newVariable` task creates a new job variable. The result is similar to promoting the outgoing variable of an automatic task to a job variable. You can create a new boolean, number, string, object, or array variable.

## Properties

| Property          | Description                                                                                                                                                                                                                                 |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| New Variable Name | Type a name for the new variable. Job variable names must adhere to the Itential Platform naming conventions. The naming rules are found in [Naming conventions](/itential-platform/developer-guide/naming-conventions).                    |
| Variable Source   | Specify where to find the value of the new variable (a job variable, a static value, or an earlier task). Select the appropriate reference task then either select the reference variable or type a new description for a static reference. |
| Value             | If the value location is static, the **Value** field becomes a text editor; type the new value. Otherwise the **Value** field becomes a dropdown list; select an existing job or task variable.                                             |

## Example

The figure below shows the `newVariable` task properties.

![](/_fern-img/d40b48513f0a0a92a740f336d93f35475670cc545529f0ae3bead7438089bd1b.webp)

## Related reading

For related information, see the [newVariable API reference](https://apidocs.itential.com/api/app-workflow_engine/newVariable/).

> Use the newVariable task to create a new job variable of type boolean, number, string, object, or array.