You are staring at the n8n canvas. You\u2019ve successfully connected a Webhook to a Google Sheet. However, there is a problem.<\/p>\n
The date format is wrong. The customer name is lowercase. Your You try to fix it. You type a code snippet, but n8n returns an error or This is the heartbeat of n8n. While n8n is famous for its visual interface, its true power lies in n8n expressions<\/b> and variables. Understanding this language is vital. It is essentially JavaScript wrapped in a templating engine.<\/p>\n Mastering this skill is the difference between building a simple toy workflow and architecting a scalable enterprise ecosystem. At Thinkpeak.ai<\/a>, we build these ecosystems every day.<\/p>\n We rely on advanced expressions to transform static data into dynamic business value. This guide is your manual. We will move beyond the basics and dive deep into the syntax and architecture of variables<\/b>.<\/p>\n Before writing code, you must understand the invisible structure holding your data. The main reason expressions fail is a misunderstanding of n8n\u2019s data structure<\/b>.<\/p>\n Every node in n8n receives data in a specific format: An Array of Objects<\/b>.<\/p>\n Even if your API returns a simple list, n8n wraps it. Standard JSON looks like a simple object with keys and values. However, n8n places that object inside a When you write an expression, you are usually trying to access data inside<\/em> that n8n tries to be helpful. When you reference a variable like If you have 10 incoming items, the node runs 10 times. In Run 1, the variable refers to Item 1. In Run 2, it refers to Item 2.<\/p>\n The trap occurs if you break this link using an Aggregate node<\/b>. You can no longer use simple shortcodes. You must use specific selectors.<\/p>\n To control your data, you need to know which selector to use. Here is the hierarchy of essential n8n variables.<\/p>\n This is the shorthand for “the data inside the current item.” use this for simple mappings where one input equals one output.<\/p>\n Usage:<\/strong> This allows you to pull data from any<\/em> previous node in your workflow. It is not limited to the node immediately connected to the current one.<\/p>\n Usage:<\/strong> Pro Tip:<\/strong> Always rename your nodes to something descriptive. For example, use “Get_Apollo_Data” instead of “HTTP Request 2”. It makes your expressions readable and debugging easier.<\/p>\n This variable accesses all<\/strong> items arriving at the node as a single array. It does not process them one by one.<\/p>\n Usage:<\/strong> Use this when you need to calculate a sum or aggregate a list of emails. It is also useful when comparing one item against the whole list.<\/p>\n These are global variables you set for the execution. Use this for configuration settings<\/b> that might change, like API keys or Channel IDs.<\/p>\n Usage:<\/strong> The n8n Expression Editor accepts JavaScript logic<\/b>. This means you aren’t limited to just selecting fields; you can transform them.<\/p>\n You often need to clean your data before it hits your CRM.<\/p>\n Capitalize First Letter:<\/strong><\/p>\n Split a Full Name:<\/strong><\/p>\n Regex Extraction:<\/strong><\/p>\n Complex string manipulation is often required for scraping and enrichment. Our Cold Outreach tools<\/b> use advanced regex patterns to scrape prospect data. Instead of building these from scratch, you can deploy our pre-architected systems at Thinkpeak.ai<\/a>.<\/p>\n Rounding Currency:<\/strong><\/p>\n Calculating Margins:<\/strong><\/p>\n You can replace entire Syntax:<\/strong> Example:<\/strong><\/p>\n Dates are the nemesis of automation. Different APIs use different formats. n8n uses a library called Luxon<\/b> to handle this.<\/p>\n Format a Date (DD\/MM\/YYYY):<\/strong><\/p>\n Calculate a Deadline (Today + 7 Days):<\/strong><\/p>\n Parse a Weird Format:<\/strong><\/p>\n If an API sends “12-25-2025”, n8n might treat it as a string. You must parse it to do math on it.<\/p>\n Timezone errors can kill a marketing campaign. We strictly use ISO 8601 formats<\/b> internally at Thinkpeak.ai<\/a>. This ensures our AI agents never miss a beat across different time zones.<\/p>\n Expressions are great for one-liners. But sometimes you find yourself writing nested ternary operators. Or, you might be trying to filter complex arrays inside the Expression Editor.<\/p>\n It is time to upgrade to the Code Node<\/b>. This node allows you to write full multi-line JavaScript or Python.<\/p>\n Example: Deduplicating a Complex List<\/strong><\/p>\n You can’t easily remove duplicates based on a specific sub-property using just expressions.<\/p>\n This is where Thinkpeak.ai<\/a> shines. Standard expressions cover most use cases. The remaining 20% involves complex business logic<\/b> and API pagination loops.<\/p>\n Our Bespoke Engineering service handles this heavy lifting. We build entire backend architectures. If you need a Custom AI Agent<\/b> capable of reasoning, we build the infrastructure to support it.<\/p>\n Even the best architects face errors. Here is how to resolve the most common ones.<\/p>\n Cause:<\/strong> You are trying to print an entire object into a text field that expects a string.<\/p>\n Fix:<\/strong> Access the specific field like Cause:<\/strong> The field you are asking for doesn’t exist in the data for that specific item.<\/p>\n Fix:<\/strong> Use the Optional Chaining<\/b> operator ( Cause:<\/strong> You are trying to use Fix:<\/strong> Connect the nodes directly. You can also use a Merge node to bring the data streams together.<\/p>\n Mastering expressions and variables takes you from “tinkerer” to “automation architect.” You can force n8n to do exactly what you want.<\/p>\n You simply need to understand the Array of Objects structure. Leverage the power of Luxon for dates. Utilize JavaScript for logic.<\/p>\n At Thinkpeak.ai<\/a>, we help businesses skip the learning curve. Check out our Automation Marketplace for pre-architected workflows.<\/p>\n If you need scale, partner with our Bespoke Engineering team. We build custom low-code apps that integrate your entire stack. Transform your business into a self-driving ecosystem today.<\/p>\n Explore the Thinkpeak.ai Automation Marketplace<\/a><\/p>\n You use the n8n dates are often strings. You must convert them to a Luxon object<\/b> before you can modify them. Use \u0130\u015f ak\u0131\u015flar\u0131n\u0131 d\u00fczeltmek i\u00e7in n8n ifadelerini, de\u011fi\u015fkenleri, Luxon tarihlerini ve hata ay\u0131klamay\u0131 kullanmaya y\u00f6nelik a\u00e7\u0131k ve pratik ad\u0131mlar \u00f6\u011frenin.<\/p>","protected":false},"author":2,"featured_media":16677,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[103],"tags":[],"class_list":["post-16678","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-business-process-automation"],"_links":{"self":[{"href":"https:\/\/thinkpeak.ai\/tr\/wp-json\/wp\/v2\/posts\/16678","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/thinkpeak.ai\/tr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/thinkpeak.ai\/tr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/thinkpeak.ai\/tr\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/thinkpeak.ai\/tr\/wp-json\/wp\/v2\/comments?post=16678"}],"version-history":[{"count":0,"href":"https:\/\/thinkpeak.ai\/tr\/wp-json\/wp\/v2\/posts\/16678\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/thinkpeak.ai\/tr\/wp-json\/wp\/v2\/media\/16677"}],"wp:attachment":[{"href":"https:\/\/thinkpeak.ai\/tr\/wp-json\/wp\/v2\/media?parent=16678"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/thinkpeak.ai\/tr\/wp-json\/wp\/v2\/categories?post=16678"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/thinkpeak.ai\/tr\/wp-json\/wp\/v2\/tags?post=16678"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}IF<\/code> node keeps returning false when it should be true.<\/p>\nundefined<\/code>. Welcome to the Expression Editor<\/b>.<\/p>\nThe Mental Model: How n8n “Thinks” About Data<\/h2>\n
The “Array of Objects” Rule<\/h3>\n
json<\/code> key within an array.<\/p>\njson<\/code> key. If you reference the top-level object directly without understanding this wrapper, your workflow will break.<\/p>\nItem Linking (The “Magic” Context)<\/h3>\n
$json.email<\/code>, n8n automatically guesses which “Item” in the list you mean.<\/p>\nThe Dictionary: Essential n8n Variables and Selectors<\/h2>\n
1. $json (The Daily Driver)<\/h3>\n
{{ $json.myField }}<\/code><\/p>\n2. $node (The Time Traveler)<\/h3>\n
{{ $node[\"Webhook\"].json.body.order_id }}<\/code><\/p>\n3. $input.all() (The Batch Selector)<\/h3>\n
{{ $input.all()[0].json.id }}<\/code><\/p>\n4. $vars (The Configurator)<\/h3>\n
{{ $vars.slack_channel_id }}<\/code><\/p>\nMastering the Expression Editor (JavaScript Logic)<\/h2>\n
String Manipulation<\/h3>\n
{{ $json.name.charAt(0).toUpperCase() + $json.name.slice(1) }}<\/code><\/pre>\n\/\/ First Name\n{{ $json.fullName.split(\" \")[0] }}\n\/\/ Last Name\n{{ $json.fullName.split(\" \").slice(1).join(\" \") }}<\/code><\/pre>\n{{ $json.subject.match(\/Order #(d+)\/)[1] }}<\/code><\/pre>\nMath and Numbers<\/h3>\n
{{ Math.round($json.price * 100) \/ 100 }}<\/code><\/pre>\n{{ ($json.revenue - $json.cost) \/ $json.revenue * 100 }}%<\/code><\/pre>\nLogic (Ternary Operators)<\/h3>\n
IF<\/code> nodes with a single line of code. This cleans up your canvas significantly.<\/p>\ncondition ? value_if_true : value_if_false<\/code><\/p>\n{{ $json.deal_size > 1000 ? \"High Priority\" : \"Standard\" }}<\/code><\/pre>\nDate & Time Manipulation with Luxon<\/h2>\n
The $now and $today Objects<\/h3>\n
\n
$now<\/code>: Returns the current date and time in ISO format.<\/li>\n$today<\/code>: Returns the current date with the time set to 00:00:00.<\/li>\n<\/ul>\nCommon Luxon Formulas<\/h3>\n
{{ $now.toFormat('dd\/MM\/yyyy') }}<\/code><\/pre>\n{{ $now.plus({ days: 7 }).toISO() }}<\/code><\/pre>\n{{ DateTime.fromFormat($json.dateString, 'MM-dd-yyyy').toFormat('yyyy-MM-dd') }}<\/code><\/pre>\nWhen Expressions Aren’t Enough: The Code Node<\/h2>\n
\/\/ Code Node Example\nconst seen = new Set();\nreturn $input.all().filter(item => {\n const duplicate = seen.has(item.json.email);\n seen.add(item.json.email);\n return !duplicate;\n});<\/code><\/pre>\nThe “Limitless” Tier<\/h3>\n
Debugging Your Expressions<\/h2>\n
1. [Object object] Output<\/h3>\n
$json.name<\/code>. Alternatively, you can stringify the object.<\/p>\n2. undefined<\/h3>\n
?.<\/code>). For example, {{ $json.address?.zipcode || \"No Zip\" }}<\/code> returns “No Zip” if the field is missing.<\/p>\n3. “Referenced Node is not ancestor”<\/h3>\n
$node<\/code> to access data from a branch that isn’t connected.<\/p>\nConclusion<\/h2>\n
Frequently Asked Questions (FAQ)<\/h2>\n
What is the difference between $json and $input.item?<\/h3>\n
$json<\/code> is actually a shorthand alias for $input.item.json<\/code>. They access the exact same data. $json<\/code> is preferred for brevity. However, $input.item<\/code> is useful if you also need to access the binary data associated with that item.<\/p>\nHow do I access data from two nodes ago?<\/h3>\n
$node<\/code> selector. For example: {{ $node[\"Name of Node\"].json.field }}<\/code>. Note that the node name must be exact and case-sensitive. If the node name has spaces, use brackets and quotes.<\/p>\nWhy does my date expression return an error?<\/h3>\n
DateTime.fromISO()<\/code> or DateTime.fromFormat()<\/code> first.<\/p>\nResources<\/h2>\n
\n