[{"data":1,"prerenderedAt":227},["ShallowReactive",2],{"node-red-\u002Fnode-red\u002Fcore-nodes\u002Fchange":3},{"id":4,"title":5,"body":6,"description":213,"extension":220,"meta":221,"navigation":222,"path":223,"seo":224,"stem":225,"__hash__":226},"nodeRed\u002Fnode-red\u002Fcore-nodes\u002Fchange.md","Node-RED - Change Node",{"type":7,"value":8,"toc":212},"minimark",[9,14,19,23,27,30,41,48,53,62,68,71,80,85,88,97,103,106,115,120,123,132,137,140,143,147],[10,11,13],"h1",{"id":12},"change","Change",[15,16,18],"h2",{"id":17},"whats-the-change-node-in-node-red-used-for","What's the Change node in Node-RED used for?",[20,21,22],"p",{},"The Change node in Node-RED is used for modifying the content of messages within a flow. It allows you to add, remove, modify, or set message properties and payload values, making it a fundamental node for data transformation and manipulation. The Change node is essential for preparing data for further processing, formatting messages for specific outputs, and adapting data to suit the requirements of downstream nodes in a flow.",[15,24,26],{"id":25},"examples-for-the-change-node","Examples for the Change node",[20,28,29],{},"Use cases for the Change node include:",[31,32,33],"ol",{},[34,35,36,40],"li",{},[37,38,39],"strong",{},"Data Transformation",": You can use the Change node to transform data from one format to another. For example, you can convert temperature values from Celsius to Fahrenheit, translate textual information, or convert timestamps to a different format.",[20,42,43],{},[44,45],"img",{"alt":46,"src":47},"Data Transform","\u002Fnode-red\u002Fcore-nodes\u002Fimages\u002Fchange-data-transform.png",[49,50],"render-flow",{":height":51,"flow":52},"200","W3siaWQiOiIxY2Q0ODY4NC4wNGRiYWIiLCJ0eXBlIjoidGFiIiwibGFiZWwiOiJUZW1wZXJhdHVyZSBDb252ZXJzaW9uIiwiZGlzYWJsZWQiOmZhbHNlLCJpbmZvIjoiIn0seyJpZCI6ImQ4MDNjM2M5LjA3NjFkOCIsInR5cGUiOiJpbmplY3QiLCJ6IjoiMWNkNDg2ODQuMDRkYmFiIiwibmFtZSI6IkNlbHNpdXMiLCJwcm9wcyI6W3sicCI6InBheWxvYWQifV0sInJlcGVhdCI6IiIsImNyb250YWIiOiIiLCJvbmNlIjpmYWxzZSwib25jZURlbGF5IjowLjEsInRvcGljIjoiIiwicGF5bG9hZCI6IjI1IiwicGF5bG9hZFR5cGUiOiJudW0iLCJ4IjoxNzAsInkiOjEwMCwid2lyZXMiOltbIjIxYjgzYjA3LjM2NTY0Il1dfSx7ImlkIjoiMjFiODNiMDcuMzY1NjQiLCJ0eXBlIjoiY2hhbmdlIiwieiI6IjFjZDQ4Njg0LjA0ZGJhYiIsIm5hbWUiOiJDb252ZXJ0IHRvIEZhaHJlbmhlaXQiLCJydWxlcyI6W3sidCI6InNldCIsInAiOiJwYXlsb2FkIiwicHQiOiJtc2ciLCJ0byI6IiRyb3VuZCgoJG51bWJlcihwYXlsb2FkKSAqIDkvNSkgKyAzMiwgMikiLCJ0b3QiOiJqc29uYXRhIn1dLCJhY3Rpb24iOiIiLCJwcm9wZXJ0eSI6IiIsImZyb20iOiIiLCJ0byI6IiIsInJlZyI6ZmFsc2UsIngiOjQxMCwieSI6MTAwLCJ3aXJlcyI6W1siZGM5MmRiNDQuYTUwYzA4Il1dfSx7ImlkIjoiZGM5MmRiNDQuYTUwYzA4IiwidHlwZSI6ImRlYnVnIiwieiI6IjFjZDQ4Njg0LjA0ZGJhYiIsIm5hbWUiOiJGYWhyZW5oZWl0IiwiYWN0aXZlIjp0cnVlLCJ0b3NpZGViYXIiOnRydWUsImNvbnNvbGUiOmZhbHNlLCJ0b3N0YXR1cyI6ZmFsc2UsImNvbXBsZXRlIjoicGF5bG9hZCIsInRhcmdldFR5cGUiOiJtc2ciLCJzdGF0dXNWYWwiOiIiLCJzdGF0dXNUeXBlIjoiYXV0byIsIngiOjYxMCwieSI6MTAwLCJ3aXJlcyI6W119XQ==",[31,54,56],{"start":55},2,[34,57,58,61],{},[37,59,60],{},"Message Filtering",": The Change node can filter out messages based on specific conditions. You can use the Change node to route messages to different outputs, discard irrelevant messages, or take specific actions based on message properties.",[20,63,64],{},[44,65],{"alt":66,"src":67},"Message Filter","\u002Fnode-red\u002Fcore-nodes\u002Fimages\u002Fchange-message-filter.png",[49,69],{":height":51,"flow":70},"W3siaWQiOiJhNDU2OTA3MC40OGY5ZDgiLCJ0eXBlIjoiaW5qZWN0IiwieiI6ImQyMzhlNDhhLjg1YzA4IiwibmFtZSI6IlNpbXVsYXRlIERhdGEiLCJwcm9wcyI6W3sicCI6InBheWxvYWQifV0sInJlcGVhdCI6IiIsImNyb250YWIiOiIiLCJvbmNlIjpmYWxzZSwib25jZURlbGF5IjowLjEsInRvcGljIjoiIiwicGF5bG9hZCI6IkJvbmpvdXIiLCJwYXlsb2FkVHlwZSI6InN0ciIsIngiOjE3MCwieSI6MTIwLCJ3aXJlcyI6W1siNTNjMzMyMzUuZTVjMjQ4Il1dfV0=",[31,72,74],{"start":73},3,[34,75,76,79],{},[37,77,78],{},"Message Enrichment",": The Change node allows you to add or modify properties in a message to enrich its content. For instance, you can add timestamps, add contextual information, or set specific identifiers for tracking purposes.",[20,81,82],{},[44,83],{"alt":78,"src":84},"\u002Fnode-red\u002Fcore-nodes\u002Fimages\u002Fchange-message-enrich.png",[49,86],{":height":51,"flow":87},"W3siaWQiOiIzNGQ0OWM3Zi41MDVkNTgiLCJ0eXBlIjoidGFiIiwibGFiZWwiOiJNZXNzYWdlIEVucmljaG1lbnQiLCJkaXNhYmxlZCI6ZmFsc2UsImluZm8iOiIifSx7ImlkIjoiZjdjMDllOGYuMDFhZjIiLCJ0eXBlIjoiaW5qZWN0IiwieiI6IjM0ZDQ5YzdmLjUwNWQ1OCIsIm5hbWUiOiJTaW11bGF0ZSBEYXRhIiwicHJvcHMiOlt7InAiOiJwYXlsb2FkIn1dLCJyZXBlYXQiOiIiLCJjcm9udGFiIjoiIiwib25jZSI6ZmFsc2UsIm9uY2VEZWxheSI6MC4xLCJ0b3BpYyI6IiIsInBheWxvYWQiOiJIZWxsbywgd29ybGQhIiwicGF5bG9hZFR5cGUiOiJzdHIiLCJ4IjoxNzAsInkiOjEyMCwid2lyZXMiOltbIjJlZjc2N2QxLjNiNWYzMiJdXX0seyJpZCI6IjJlZjc2N2QxLjNiNWYzMiIsInR5cGUiOiJjaGFuZ2UiLCJ6IjoiMzRkNDljN2YuNTA1ZDU4IiwibmFtZSI6IkFkZCBUaW1lc3RhbXAiLCJydWxlcyI6W3sidCI6InNldCIsInAiOiJ0aW1lc3RhbXAiLCJwdCI6Im1zZyIsInRvIjoiJG5vdygpIiwidG90IjoianNvbmF0YSJ9XSwiYWN0aW9uIjoiIiwicHJvcGVydHkiOiIiLCJmcm9tIjoiIiwidG8iOiIiLCJyZWciOmZhbHNlLCJ4IjozNjAsInkiOjEyMCwid2lyZXMiOltbImUzYjBjOTQ5LmMyMGJhIl1dfSx7ImlkIjoiZTNiMGM5NDkuYzIwYmEiLCJ0eXBlIjoiZGVidWciLCJ6IjoiMzRkNDljN2YuNTA1ZDU4IiwibmFtZSI6IkVucmljaGVkIE1lc3NhZ2UiLCJhY3RpdmUiOnRydWUsInRvc2lkZWJhciI6dHJ1ZSwiY29uc29sZSI6ZmFsc2UsInRvc3RhdHVzIjpmYWxzZSwiY29tcGxldGUiOiJwYXlsb2FkIiwidGFyZ2V0VHlwZSI6Im1zZyIsInN0YXR1c1ZhbCI6IiIsInN0YXR1c1R5cGUiOiJhdXRvIiwieCI6NTgwLCJ5IjoxMjAsIndpcmVzIjpbXX1d",[31,89,91],{"start":90},4,[34,92,93,96],{},[37,94,95],{},"Renaming Properties",": The Change node allows you to rename message properties, making it easier to understand and work with data at various points in your flow.",[20,98,99],{},[44,100],{"alt":101,"src":102},"Example","\u002Fnode-red\u002Fcore-nodes\u002Fimages\u002Fchange-rename-property.png",[49,104],{":height":51,"flow":105},"W3siaWQiOiI1ZTYwNTRiOS44YjZhNjQiLCJ0eXBlIjoidGFiIiwibGFiZWwiOiJSZW5hbWluZyBQcm9wZXJ0aWVzIiwiZGlzYWJsZWQiOmZhbHNlLCJpbmZvIjoiIn0seyJpZCI6ImNhOGEwM2YzLjExOWQxOCIsInR5cGUiOiJpbmplY3QiLCJ6IjoiNWU2MDU0YjkuOGI2YTY0IiwibmFtZSI6IlNpbXVsYXRlIERhdGEiLCJwcm9wcyI6W3sicCI6InBheWxvYWQifV0sInJlcGVhdCI6IiIsImNyb250YWIiOiIiLCJvbmNlIjpmYWxzZSwib25jZURlbGF5IjowLjEsInRvcGljIjoiIiwicGF5bG9hZCI6IntcImRhdGFcIjoxMjN9IiwicGF5bG9hZFR5cGUiOiJqc29uIiwieCI6MTcwLCJ5IjoxMjAsIndpcmVzIjpbWyJkNDRkZTA1Mi5hNzdkIl1dfSx7ImlkIjoiZDQ0ZGUwNTIuYTc3ZCIsInR5cGUiOiJjaGFuZ2UiLCJ6IjoiNWU2MDU0YjkuOGI2YTY0IiwibmFtZSI6IlJlbmFtZSBQcm9wZXJ0eSIsInJ1bGVzIjpbeyJ0Ijoic2V0IiwicCI6InNlbnNvckRhdGEiLCJwdCI6Im1zZyIsInRvIjoicGF5bG9hZC5kYXRhIiwidG90IjoibXNnIn0seyJ0IjoiZGVsZXRlIiwicCI6InBheWxvYWQuZGF0YSIsInB0IjoibXNnIn1dLCJhY3Rpb24iOiIiLCJwcm9wZXJ0eSI6IiIsImZyb20iOiIiLCJ0byI6IiIsInJlZyI6ZmFsc2UsIngiOjM4MCwieSI6MTIwLCJ3aXJlcyI6W1siNjkwZTZkZTEuM2FkMjE4Il1dfSx7ImlkIjoiNjkwZTZkZTEuM2FkMjE4IiwidHlwZSI6ImRlYnVnIiwieiI6IjVlNjA1NGI5LjhiNmE2NCIsIm5hbWUiOiJSZW5hbWVkIFByb3BlcnR5IiwiYWN0aXZlIjp0cnVlLCJ0b3NpZGViYXIiOnRydWUsImNvbnNvbGUiOmZhbHNlLCJ0b3N0YXR1cyI6ZmFsc2UsImNvbXBsZXRlIjoic2Vuc29yRGF0YSIsInRhcmdldFR5cGUiOiJtc2ciLCJzdGF0dXNWYWwiOiIiLCJzdGF0dXNUeXBlIjoiYXV0byIsIngiOjU3MCwieSI6MTIwLCJ3aXJlcyI6W119XQ==",[31,107,109],{"start":108},5,[34,110,111,114],{},[37,112,113],{},"Default Values",": If a message lacks certain properties, the Change node can set default values for those properties, ensuring consistency in the data flow.",[20,116,117],{},[44,118],{"alt":101,"src":119},"\u002Fnode-red\u002Fcore-nodes\u002Fimages\u002Fchange-default.png",[49,121],{":height":51,"flow":122},"W3siaWQiOiIzYWJiZTg4Yi41MzdhYzQiLCJ0eXBlIjoidGFiIiwibGFiZWwiOiJEZWZhdWx0IFZhbHVlcyIsImRpc2FibGVkIjpmYWxzZSwiaW5mbyI6IiJ9LHsiaWQiOiI5NDdkY2FiMy40N2U4YiIsInR5cGUiOiJpbmplY3QiLCJ6IjoiM2FiYmU4OGIuNTM3YWM0IiwibmFtZSI6IlNpbXVsYXRlIERhdGEiLCJwcm9wcyI6W3sicCI6InBheWxvYWQifV0sInJlcGVhdCI6IiIsImNyb250YWIiOiIiLCJvbmNlIjpmYWxzZSwib25jZURlbGF5IjowLjEsInRvcGljIjoiIiwicGF5bG9hZCI6IntcIm5hbWVcIjpcIkFsaWNlXCJ9IiwicGF5bG9hZFR5cGUiOiJqc29uIiwieCI6MTcwLCJ5IjoxMjAsIndpcmVzIjpbWyJhOGQzY2U1Yy43OTgyYyJdXX0seyJpZCI6ImE4ZDNjZTVjLjc5ODJjIiwidHlwZSI6ImNoYW5nZSIsInoiOiIzYWJiZTg4Yi41MzdhYzQiLCJuYW1lIjoiU2V0IERlZmF1bHQgQWdlIiwicnVsZXMiOlt7InQiOiJtaXNzaW5nIiwicCI6InBheWxvYWQuYWdlIiwicHQiOiJtc2cifSx7InQiOiJzZXQiLCJwIjoicGF5bG9hZC5hZ2UiLCJwdCI6Im1zZyIsInRvIjoiMjUiLCJ0b3QiOiJudW0ifV0sImFjdGlvbiI6IiIsInByb3BlcnR5IjoiIiwiZnJvbSI6IiIsInRvIjoiIiwicmVnIjpmYWxzZSwieCI6MzcwLCJ5IjoxMjAsIndpcmVzIjpbWyJmNTg5MjU2Ny4zYmJkOCJdXX0seyJpZCI6ImY1ODkyNTY3LjNiYmQ4IiwidHlwZSI6ImRlYnVnIiwieiI6IjNhYmJlODhiLjUzN2FjNCIsIm5hbWUiOiJFbnJpY2hlZCBEYXRhIiwiYWN0aXZlIjp0cnVlLCJ0b3NpZGViYXIiOnRydWUsImNvbnNvbGUiOmZhbHNlLCJ0b3N0YXR1cyI6ZmFsc2UsImNvbXBsZXRlIjoicGF5bG9hZCIsInRhcmdldFR5cGUiOiJtc2ciLCJzdGF0dXNWYWwiOiIiLCJzdGF0dXNUeXBlIjoiYXV0byIsIngiOjU1MCwieSI6MTIwLCJ3aXJlcyI6W119XQ==",[31,124,126],{"start":125},6,[34,127,128,131],{},[37,129,130],{},"Message Formatting",": When sending data to external systems or services, the Change node can format the message payload in the required format (e.g., JSON, XML) or adjust data to match specific API requirements.",[20,133,134],{},[44,135],{"alt":101,"src":136},"\u002Fnode-red\u002Fcore-nodes\u002Fimages\u002Fchange-message-format.png",[49,138],{":height":51,"flow":139},"W3siaWQiOiI0OWUzNzcxNy44YzNkOTgiLCJ0eXBlIjoidGFiIiwibGFiZWwiOiJNZXNzYWdlIEZvcm1hdHRpbmciLCJkaXNhYmxlZCI6ZmFsc2UsImluZm8iOiIifSx7ImlkIjoiNGI5N2ExZjIuYmY3YTBjIiwidHlwZSI6ImluamVjdCIsInoiOiI0OWUzNzcxNy44YzNkOTgiLCJuYW1lIjoiU2ltdWxhdGUgRGF0YSIsInByb3BzIjpbeyJwIjoicGF5bG9hZCJ9XSwicmVwZWF0IjoiIiwiY3JvbnRhYiI6IiIsIm9uY2UiOmZhbHNlLCJvbmNlRGVsYXkiOjAuMSwidG9waWMiOiIiLCJwYXlsb2FkIjoie1widGVtcGVyYXR1cmVcIjoyOCxcImh1bWlkaXR5XCI6NTB9IiwicGF5bG9hZFR5cGUiOiJqc29uIiwieCI6MTcwLCJ5IjoxMjAsIndpcmVzIjpbWyJmMzAzY2UzNi5lM2MxZiJdXX0seyJpZCI6ImYzMDNjZTM2LmUzYzFmIiwidHlwZSI6ImNoYW5nZSIsInoiOiI0OWUzNzcxNy44YzNkOTgiLCJuYW1lIjoiRm9ybWF0IGFzIEpTT04iLCJydWxlcyI6W3sidCI6InNldCIsInAiOiJwYXlsb2FkIiwicHQiOiJtc2ciLCJ0byI6InBheWxvYWQudGVtcGVyYXR1cmUgJiBcIiDCsEMsIEh1bWlkaXR5OiBcIiAmIHBheWxvYWQuaHVtaWRpdHkgJiBcIiVcIiIsInRvdCI6Impzb25hdGEifV0sImFjdGlvbiI6IiIsInByb3BlcnR5IjoiIiwiZnJvbSI6IiIsInRvIjoiIiwicmVnIjpmYWxzZSwieCI6MzYwLCJ5IjoxMjAsIndpcmVzIjpbWyJkN2MxYWY5Zi5mMTA5OSJdXX0seyJpZCI6ImQ3YzFhZjlmLmYxMDk5IiwidHlwZSI6ImRlYnVnIiwieiI6IjQ5ZTM3NzE3LjhjM2Q5OCIsIm5hbWUiOiJGb3JtYXR0ZWQgTWVzc2FnZSIsImFjdGl2ZSI6dHJ1ZSwidG9zaWRlYmFyIjp0cnVlLCJjb25zb2xlIjpmYWxzZSwidG9zdGF0dXMiOmZhbHNlLCJjb21wbGV0ZSI6InBheWxvYWQiLCJ0YXJnZXRUeXBlIjoibXNnIiwic3RhdHVzVmFsIjoiIiwic3RhdHVzVHlwZSI6ImF1dG8iLCJ4Ijo1ODAsInkiOjEyMCwid2lyZXMiOltdfV0=",[20,141,142],{},"Overall, the Change node is a crucial tool for data manipulation and orchestration in Node-RED flows. Its flexibility and range of operations make it an essential node for customizing messages according to your specific use cases and the requirements of the nodes within your flow.",[15,144,146],{"id":145},"node-documentation","Node Documentation",[148,149,152,155,156,155,159,155,164,155,167,155,202],"div",{"className":150},[151],"core-node-doc",[20,153,154],{},"Set, change, delete or move properties of a message, flow context or global context."," ",[20,157,158],{},"The node can specify multiple rules that will be applied in the order they are defined.",[160,161,163],"h3",{"id":162},"details","Details",[20,165,166],{},"The available operations are:",[168,169,172,176,180,182,190,193,196,199],"dl",{"className":170},[171],"message-properties",[173,174,175],"dt",{},"Set",[177,178,179],"dd",{},"set a property. The value can be a variety of different types, or\ncan be taken from an existing message or context property.",[173,181,13],{},[177,183,184,185,189],{},"search & replace parts of the property. If regular expressions\nare enabled, the \"replace with\" property can include capture groups, for\nexample ",[186,187,188],"code",{},"$1",". Replace will only change the type if there\nis a complete match.",[173,191,192],{},"Delete",[177,194,195],{},"delete a property.",[173,197,198],{},"Move",[177,200,201],{},"move or rename a property.",[20,203,204,205,211],{},"The \"expression\" type uses the ",[206,207,210],"a",{"href":208,"target":209},"http:\u002F\u002Fjsonata.org\u002F","_new","JSONata","\nquery and expression language.\n",{"title":213,"searchDepth":55,"depth":55,"links":214},"",[215,216,217],{"id":17,"depth":55,"text":18},{"id":25,"depth":55,"text":26},{"id":145,"depth":55,"text":146,"children":218},[219],{"id":162,"depth":73,"text":163},"md",{},true,"\u002Fnode-red\u002Fcore-nodes\u002Fchange",{"title":5,"description":213},"node-red\u002Fcore-nodes\u002Fchange","PFf8soM4D_I2uD6n1NpNWxkM92pTbK5Kl90Arz57qis",1780070555724]