n8n-code-python

1# Python Code Node (native)
2 
3Since n8n 2.0 the Code node's Python runs as **native Python in a task runner** (`language:
4"pythonNative"`). The old Pyodide "Python (Beta)" is gone, and with it every n8n helper it had:
5`_input`, `_json`, `_node`, `_now`, `_today` and `_jmespath` all raise `NameError` now. Code copied
6from old templates, forum posts or older docs usually breaks on this.
7 
8---
9 
10## JavaScript first — stronger than before
11 
12Native Python gives you two variables and plain Python, and **by default no imports**: no
13`json`, `datetime` or `re`. Everything n8n-specific (`$('Node')`, `$jmespath`, Luxon,
14`this.helpers.httpRequest`, static data) exists only in JavaScript. Use Python only when the user
15explicitly asks for it. Even then, first check whether an expression, Edit Fields, or a native
16node (Crypto, Date & Time, HTML, XML) does the job. See **n8n-code-javascript** and the transform
17gatekeeper in **n8n-expression-syntax**.
18 
19---
20 
21## Quick start
22 
23```python
24# Run Once for All Items (default mode)
25return [
26    {"json": {"name": it["json"]["name"], "revenue": it["json"]["revenue"]}}
27    for it in _items
28    if it["json"].get("active")
29]
30```
31 
32```python
33# Run Once for Each Item
34row = _item["json"]
35return {"json": {**row, "name_upper": (row.get("name") or "").upper()}}
36```
37 
38Node config: `{"language": "pythonNative", "mode": "runOnceForAllItems" | "runOnceForEachItem",
39"pythonCode": "..."}` on `n8n-nodes-base.code` typeVersion 2.
40 
41---
42 
43## The only inputs: `_items` and `_item`
44…