---
title: "setReplacementVariables"
canonical: "https://support.appfire.com/space/CSOAP/68455536/setReplacementVariables"
format: markdown
---
> Macro (aura-html)

See also: [Actions](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68458401)

> Macro (details)
> 
> | **Description** | Set one or more replacement variables specified using field parameters with name=value syntax or loaded from a property file. Value specified replaces any previously set variable with the same name including values set by other actions that set replacement variables. This is an example to save a previously set value, use '--field myIssue=@issue@'. Find and replace logic is applied to the value before setting the variable providing a way to manipulate values in a script. Variables are available only within the scope of the run script they were set in. If a regex based condition is provide using the regex and value parameters, the variables will only be set if the regex condition is met. By default, the regex is used for a find of the value parameter. The options parameter can be set to one or more of the following to modify the default behavior - literal - to treat the regex string as a literal string, exact - to require an exact match of the value, negative - to reverse the condition so a match means do NOT set the variables. In addition, use blank for the regex parameter to match on an empty string. |
> | --- | --- |
> | **Required Parameters** |  |
> | **Optional Parameters** | [field](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68459567), [file](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68455055), [findReplace](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68454887), [findReplaceRegex](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68457861), [regex](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68458942), [value](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68458892), [options](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68459041) |
> | **Type** | [Update](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68455033/Action+Types#ActionTypes-Update) |
> | **Category** | [Variables](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68455044/Action+Categories#ActionCategories-Variables) |
> | **Output Formats** |  |
> | **Replacement Variables** |  |
> | **Hosting** |  |
> | **Since Version** |  |
> | **Examples** |  |

## Related How To's

> Macro (cql-query)