---
title: "User Defined Substitution Variables"
canonical: "https://support.appfire.com/space/JCLI/71139573/User%20Defined%20Substitution%20Variables"
format: markdown
---
> Macro (aura-html)

# Summary

Starting with release 4.2, there is a configuration panel available for user defined substitution variables. For more information on all substitution variables see [Substitution variables](https://appfire.atlassian.net/wiki/spaces/JCLIP/pages/71139762).

# Configuration

Configuration is a simple name/value pair.

- The configuration screen is available from the **UPM entry** or the **Add-ons** administrations tab
- The name field must not contain **%** and we recommend using using relatively simple names without special characters
- Variable names are **case sensitive**
- Variable names are trimmed of leading and trailing blanks
- Variables are sorted alphabetically
- To remove a variable, blank out the name and save

![image](media://79b718e0-6d9c-4c3d-b5cc-4dbae23503b3)

# Use

- Use is similar to all other substitution variables, a prefix of **variable** indicates a user defined variable
- Example: **%variable_jira-local%**
- User defined variables can be used in any action definition ([run UI](https://appfire.atlassian.net/wiki/spaces/JCLIP/pages/71139817), [CLI Post Function and CLI Validator](https://appfire.atlassian.net/wiki/spaces/JCLIP/pages/71139662))
- Substitution is a simple text substitution with recursion on user defined variables (there is no recursion on standard substitution variables)
- Variable names are **case sensitive**

![image](media://a86bc77b-99ff-453c-b416-5c161daa0966)