Custom variables

custom variables are similar to scenario variables docid\ xheaxlxyife v0osuxxpe , but they are defined at the organization or team level custom variables are available only on pro, teams, and enterprise pricing plans see make pricing for more information for each variable, you need to identify the name (permanent variable name) data type (text, number, boolean, or date) value (the actual value of the variable) here are some situations for which you might use custom variables keep track of a value between multiple {{scenario singular lowercase}} executions share a value between different {{scenario plural lowercase}} set a global variable that various {{scenario plural lowercase}} leverage for example testmode = true/false so the {{scenario singular lowercase}} routes differently according to the value change the behavior of a {{scenario singular lowercase}} without modifying the {{scenario singular lowercase}} blueprint for example, mylimit=20 set as a custom variable in the limit field of a module variables are not meant to store secrets don’t use them for anything sensitive! variable values are not encrypted as they are stored in plain text don’t use variables to store passwords or any other sensitive data be aware that other team members and organization admins can access all custom variables create a custom variable you can create custom variables at the organization level and at the team level decide if you want to create an organization variable or a team variable for organization variables, go to the organization dashboard and click variables > add organization variable for team variables, go to the team dashboard and click variables > add team variable fill in the following information field description name this field is mandatory and you cannot change it after you save it the name is the identifier of the variable the name must contain only letters, digits, or the symbols $ and the name cannot start with a digit the name must contain a maximum of 128 characters data type choose the variable data type from the dropdown menu number text boolean date value enter the value for your variable you can use letters, digits, spaces, and special characters value cannot be empty click save to save your custom variable your new variable will appear in the list of variables to preview the variable value, hover over the individual value field edit a custom variable if your other team members or organization admins use the same variable in their {{scenario plural lowercase}} , the changes will affect them too go to the variable you want to edit for organization variables, go to the organization dashboard and click variables for team variables, go to the team dashboard and click variables in the list of your custom variables, find the one you want to edit and click edit next to it edit the variable as needed you can edit the variable data type and value you can't edit the name click save to save your changes your changes are saved and your updated variable will appear on the list of variables hover over the individual value field to preview the variable value the changes automatically update in the {{scenario plural lowercase}} that already use the variable the value of a custom variable can be changed within a {{scenario singular lowercase}} as well the value changes only after the {{scenario singular lowercase}} finishes running the new value is available for the next run of the {{scenario singular lowercase}} for everyone in the organization or team delete a custom variable deleting a variable that you already use in one or more {{scenario plural lowercase}} can affect other users who use the same variable in their {{scenario plural lowercase}} after you delete a variable, the variable becomes inactive in all {{scenario plural lowercase}} where it is used and it stops returning expected values decide if you want to delete an organization variable or a team variable for organization variables, go to the organization dashboard and click variables for team variables, go to the team dashboard and click variables in the list of your custom variables find the one you want to delete and click delete next to it delete a custom variable click ok to confirm that you want to delete the variable if the custom variable you are deleting is already used, you will see a pop up that lists all scenarios that will be impacted if you still want to delete it, click ok the variable is deleted and disappears from your list of custom variables check custom variable history you can see who changed the custom variable, when, and what the changes are go to the custom variable whose history you want to check for organization variables, go to the organization dashboard and click variables for team variables, go to the team dashboard and click variables click the dropdown menu next to edit select show history a new window opens where you can see the variable history the last change appears on the top user permissions for custom variables organization variables owner admin member accountant app developer can access organization variables x x x x can edit organization variables x x can add organization variables x x can delete organization variables x x team variables team admin team member team monitoring team operator team restricted member can access team variables x x x x can add team variables x x x can edit team variables x x x can delete team variables x x x example use a custom variable to control a {{scenario singular lowercase}} you can use a custom variable at the organization or team level to easily switch the value and control how a {{scenario singular lowercase}} works here, a custom variable called debugmode is boolean, and if the value is true an email will be sent to a team member if you change the value to false at the team level, the scenario will end after adding a row to the google sheets document custom variable scenario example decide if you want to create an organization variable or a team variable for organization variables, go to the organization dashboard and click variables > add organization variable for team variables, go to the team dashboard and click variables > add team variable in this example, we are using a team variable enter your variable name , data type , and value name debugmode data type boolean value yes click save to save your custom variable in your {{scenario singular lowercase}} , add a tools > set variable module set the variable name to city and the variable value to madrid click save add a weather > get current weather module in the i want to enter a location by field, select cities in the city field, map the value to the city variable that you set in step 3 click save add a google sheets > add a row module and create a connection in this example, we have a google sheets document called weather report saved in my drive this file has headers for the date , city , average temp , status , and description connect to this file and map values as shown field mapped value date formatdate(now; "dd mm yyyy") city {{scenario singular}} variable city average temp weather app value temperature status weather app value status description weather app value description click save add an email > send an email to a team member module and create a connection in the to field, select the member of your team you want to send the email to in the subject field, enter a relevant subject in the content field, enter the text of your email, mapping the information you want to share with your team member you can use html tags click save in your {{scenario singular lowercase}} , between the google sheets and email modules, click the wrench icon to set up a filter label debug mode? condition map the condition to the debugmode custom variable change the operator to boolean operators equal to and enter true in the field click save click the save icon to save your {{scenario singular lowercase}} and click run once to test if your custom variable value is yes , an email is sent to your team member custom variable email example if the custom variable value is no , the email is not sent after the weather information is stored in the google sheets document