[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-n8n-n8n-data-tables-official":3,"mdc-kfosje-key":33,"related-org-n8n-n8n-data-tables-official":1495,"related-repo-n8n-n8n-data-tables-official":1651},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":23,"repoUrl":24,"updatedAt":25,"license":26,"forks":27,"topics":28,"repo":29,"sourceUrl":31,"mdContent":32},"n8n-data-tables-official","manage n8n Data Tables","Use when working with n8n's built-in Data Tables, designing schemas, inserting\u002Fupdating\u002Fupserting rows, deduping, or querying. Triggers on \"Data Table\", \"data table\", `n8n-nodes-base.dataTable`, \"dedup\", \"idempotency\", \"lookup\", \"persistent state\", \"store across executions\", or any schema design discussion inside n8n.",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},"n8n","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fn8n.png","n8n-io",[12,14,17,20],{"name":8,"slug":8,"type":13},"tag",{"name":15,"slug":16,"type":13},"Database","database",{"name":18,"slug":19,"type":13},"Data Modeling","data-modeling",{"name":21,"slug":22,"type":13},"Workflow Automation","workflow-automation",319,"https:\u002F\u002Fgithub.com\u002Fn8n-io\u002Fskills","2026-07-08T05:44:52.048039",null,30,[],{"repoUrl":24,"stars":23,"forks":27,"topics":30,"description":26},[],"https:\u002F\u002Fgithub.com\u002Fn8n-io\u002Fskills\u002Ftree\u002FHEAD\u002Fskills\u002Fn8n-data-tables-official","---\nname: n8n-data-tables-official\ndescription: Use when working with n8n's built-in Data Tables, designing schemas, inserting\u002Fupdating\u002Fupserting rows, deduping, or querying. Triggers on \"Data Table\", \"data table\", `n8n-nodes-base.dataTable`, \"dedup\", \"idempotency\", \"lookup\", \"persistent state\", \"store across executions\", or any schema design discussion inside n8n.\n---\n\n# n8n Data Tables\n\nData Tables are n8n's **built-in tabular storage**: real tables inside the n8n instance with columns, types, rows, and CRUD via the `dataTable` node and data-table MCP tools.\n\nUse them for local persistent state: lookup tables, recent events, per-session inventories, counters, idempotency tracking, dedup state when there's row-level logic or external visibility (plain \"have I seen this value?\" dedup belongs in the `Remove Duplicates` node). Small-to-moderate volume (tens of thousands of rows fine, millions belong in a real DB).\n\n## Non-negotiables\n\n1. **System-managed columns + external IDs.** Three columns auto-exist on every table: `id` (bigserial), `createdAt`, `updatedAt`. Don't declare them in `create_data_table` (errors or shadows the system column). Don't write them on insert. For domain identifiers from outside (arxivId, stripeCustomerId, requestId), add a separate column and key dedup\u002Flookup on that.\n2. **Only primitives in columns, nested data uses `string` + `_object` postfix.** No JSON\u002Fobject\u002Farray column types exist. For nested data (arrays, parsed objects), use a `string` column with `JSON.stringify(...)` on write and `JSON.parse(...)` on read. Mark the column with `_object` (e.g., `keyInsights_object`). The postfix is the contract that tells readers to parse. See `references\u002FSCHEMA_DESIGN.md`.\n\n## Strong defaults\n\n- **Don't add a Set node before a Data Table node to modify fields.** The Data Table node's per-column expression slots are just as powerful as Set fields, so the Set node is doing zero work the Data Table node can't do itself. (Same Set-node antipattern called out in `n8n-expressions-official`.)\n- **Match n8n's column casing: camelCase.** The auto-managed columns are camelCase (`createdAt`, `updatedAt`), so user columns read more cleanly when they match: `arxivId`, `paperId`, `taxRate`. Mixed casing in the same query (`createdAt >= ... AND arxiv_id eq ...`) reads as a typo. Keep the `_object` postfix on stringified-blob columns regardless (`keyInsights_object`), the underscore is a contract marker, not casing.\n\u003C!-- TEMPORARY: remove when the data tables node quirk is fixed -->\n- **Verify the `columns` parameter via `get_workflow_details` after create\u002Fupdate.** The UI has a display quirk in manual mapping mode (\"Currently no items exist\" with no actual data loss). Checking the JSON confirms what's persisted.\n- **Relational design works when the shape calls for it.** For genuine parent-child data (papers → summaries, customers → orders), reference parents by `id`, name columns explicitly (`paperId`, `customerId`), and enforce integrity in workflow logic. Don't force it on flat use cases (dedup, lookup, audit) where there's no relationship to model.\n- **Storage format is not interface format.** Parse `_object` fields *before* returning them from a sub-workflow. Callers should never receive stringified shells they have to parse themselves. See `references\u002FSCHEMA_DESIGN.md` \"Storage format ≠ interface format\".\n\n## The default columns\n\nEvery Data Table has these whether you declare them or not:\n\n| Column | Type | Behavior |\n|---|---|---|\n| `id` | bigserial \u002F number | Auto-incrementing primary key. n8n assigns on insert, and you can't write to it. Returned in the insert response. |\n| `createdAt` | timestamp | Set automatically on insert. |\n| `updatedAt` | timestamp | Refreshed automatically on each update. |\n\nIn practice:\n\n- **Don't declare them** in `create_data_table`. Already there.\n- **Use them in queries** without your own timestamp columns. \"Created today\": `createdAt >= '\u003Ctoday ISO>'`. \"Updated since last sync\": `updatedAt >= $('Last Sync').item.json.timestamp`.\n- **Don't use them as cross-system identifiers.** Auto-`id` is internal, and resets on table recreate or instance migration. For domain identifiers, use your own column.\n\n## Relational design when the shape calls for it\n\nData Tables don't enforce foreign keys, but you can still model parent-child data across tables when the data genuinely has that shape. The catch: integrity is your responsibility, not n8n's.\n\n- **Reference parent rows by `id`.** A child table holds the parent's `id` in a column.\n- **Document references in column names.** `paperId`, `customerId`, `eventId` make the relationship obvious.\n- **Enforce integrity in workflow logic.** Before inserting a child, look up the parent. Before deleting a parent, decide what happens to children (delete, orphan, archive). n8n won't cascade.\n- **Watch for stale references.** Children pointing at deleted parents are silent bugs. Soft-delete, or run cleanup workflows.\n\nFor complex relational structure (3+ tables with joins, transactional writes), reach for an actual SQL DB.\n\n## Operations: which one for what\n\n| Operation | When |\n|---|---|\n| `insert` | Always-add. New row, n8n assigns `id`. |\n| `upsert` | \"Add if new, update if exists.\" Needs a `matchType` and filter to decide existence. |\n| `update` | \"Modify rows matching this filter.\" No insert if no match. |\n| `get` | Fetch rows matching a filter (returns 0+). Supports `orderBy`, `limit`, `returnAll`. |\n| `deleteRows` | Remove rows matching a filter. |\n| `rowExists` \u002F `rowNotExists` | Boolean-style filter against incoming items. Common for dedup branching. |\n\nFor the full operation surface (filter syntax, matchType, sort patterns), see `references\u002FOPERATIONS.md`.\n\n\u003C!-- TEMPORARY: remove when the data tables node quirk is fixed -->\n## The \"Currently no items exist\" UI quirk\n\nWhen the SDK saves manual-mode column mappings (`mappingMode: 'defineBelow'`), the n8n UI's \"Values to insert\" pane can render empty (\"Currently no items exist\") even though runtime persists data correctly. If the user reports the Insert node \"looks broken\" or \"has no fields,\" tell them: it's a UI display issue, press the reload (refresh) button on the columns parameter, and it repopulates the schema and the mappings render. No data loss, safe to do anytime.\n\n\u003C!-- TEMPORARY: SDK-saved defineBelow column mappings can render as \"Currently no items exist\" in the n8n UI until the user clicks the reload button on the columns parameter. Runtime persistence unaffected. Remove this section once n8n auto-refreshes the schema on workflow load. -->\n\n## Common patterns\n\n### Dedup by external ID\n\nDefault to the `Remove Duplicates` node (\"items seen in previous executions\" mode) for plain \"have I seen this value?\" dedup. It's a one-node solution with an internal store, no schema to maintain. Data Tables only earn the slot when there's a reason for the dedup state to live in a real table:\n\n- **You'll query or inspect the dedup state.** Dashboards, audit, \"what have we processed in the last week?\"\n- **Row-level logic on hits.** Per-category TTL (\"expire after 30 days for category A, 7 days for category B\"), conditional re-process based on stored state, branching on a status column.\n- **Per-tenant or per-user namespacing** that the `Remove Duplicates` history-store can't express.\n\nWhen that bar is met:\n\n```\n[Source: { arxivId, ... }]\n   ↓\n[Data Table Get: filter arxivId eq $json.arxivId, limit 1]\n   ↓\n[IF: result has items?]\n   ├── Yes → [Skip, or apply row-level logic from the stored row]\n   └── No  → [Process] → [Data Table Insert: { arxivId, ...rest }]\n```\n\nFor the full pattern surface (upsert, rowNotExists, Get+IF, idempotency keys), see `references\u002FDEDUP_PATTERNS.md`.\n\n### Lookup tables\n\nStable reference data (country → tax rate, plan → feature flags). Edited via n8n UI, and workflows read at execution:\n\n```\n[Data Table Get: filter country eq $json.country, limit 1]\n   ↓\n[Use the looked-up row's taxRate, etc.]\n```\n\n### Recent events \u002F audit trail\n\nAppend-only insert, queried later:\n\n```\n[Workflow event] → [Data Table Insert: { userId, eventType, payloadSummary }]\n```\n\n`createdAt` makes \"recent events in the last hour\" trivial without your own timestamp.\n\n## Reference files\n\n| File | Read when |\n|---|---|\n| `references\u002FSCHEMA_DESIGN.md` | Designing columns\u002Ftypes, the no-FK relational pattern, mapping mode (`defineBelow` vs `autoMapInputData`), when Data Tables are the wrong tool |\n| `references\u002FOPERATIONS.md` | Operation surface (insert\u002Fupsert\u002Fupdate\u002Fget\u002Fdelete\u002FrowExists), filter syntax, matchType, orderBy |\n| `references\u002FDEDUP_PATTERNS.md` | Idempotency keys, RemoveDuplicates node vs Data Table dedup, search-then-insert vs upsert |\n\nFor expression discipline (`$json` vs `$('Node Name').item.json`, the Set-node antipattern), see `n8n-expressions-official`. For Merge convergence and same-shape branches, see `n8n-node-configuration-official` `references\u002FMERGE_NODE.md`.\n\n## Anti-patterns\n\n| Anti-pattern | What goes wrong | Fix |\n|---|---|---|\n| Set node upstream of Insert \"to shape the input\" | Extra node for nothing, classic Set antipattern, field shape drifts when you add columns | Map directly in the Insert node's per-column slots, OR rename upstream fields to enable auto-map |\n| Declaring `id`, `createdAt`, `updatedAt` in `create_data_table` | Errors, or shadows the system column with a user column that doesn't auto-update | Don't declare them, they're already there |\n| Storing application-critical data in Data Tables | If n8n breaks, you lose access | Use a real DB for data you can't lose |\n| Cross-app system-of-record in Data Tables | Hard to share with non-n8n consumers, awkward query surface | Use a real DB |\n| Treating auto-`id` as a stable cross-instance identifier | Resets if the table is recreated, not portable | Use a domain ID column (`arxivId`, `requestId`) for cross-system references |\n| Foreign-key cascade assumptions | n8n doesn't cascade, deleted parents leave orphan children | Soft-delete, or run cleanup workflows that maintain referential integrity |\n| Referencing an immediately-prior node when an intermediate stripped json | Insert silently writes NULLs for fields that \"should be there\" | Reference a stable upstream node by name, or use a NoOp\u002FMerge convergence anchor (see `n8n-expressions-official` and `n8n-node-configuration-official` `references\u002FMERGE_NODE.md`) |\n| Manual-map mode + Set node to fix \"Currently no items exist\" | Doesn't fix anything, that's a UI quirk, you've added a useless Set node | Verify via `get_workflow_details` that `columns.value` has your mappings, runtime is fine. Tell the user to press the reload button on the columns parameter to make the UI render the fields. |\n\n## Verification before publishing\n\nAfter creating or updating a workflow that uses Data Tables:\n\n1. `validate_workflow` passes.\n2. `get_workflow_details` and inspect each Data Table node's `columns`. Both `value` and (for manual map) `schema` populated.\n3. `test_workflow` with pinned data. Insert response should include `id`, `createdAt`, `updatedAt`.\n4. Inspect actual Data Table contents via UI or follow-up Get to confirm columns aren't silently NULL.\n\nStep 4 especially the first time you wire a new Insert. Context-stripping intermediates + manual map + UI quirk silently produce NULL columns.\n",{"data":34,"body":35},{"name":4,"description":6},{"type":36,"children":37},"root",[38,47,70,83,90,209,215,304,396,402,407,502,507,569,575,580,656,661,667,834,846,852,865,871,878,890,930,935,947,959,965,970,979,985,990,999,1009,1015,1101,1142,1148,1398,1404,1409,1490],{"type":39,"tag":40,"props":41,"children":43},"element","h1",{"id":42},"n8n-data-tables",[44],{"type":45,"value":46},"text","n8n Data Tables",{"type":39,"tag":48,"props":49,"children":50},"p",{},[51,53,59,61,68],{"type":45,"value":52},"Data Tables are n8n's ",{"type":39,"tag":54,"props":55,"children":56},"strong",{},[57],{"type":45,"value":58},"built-in tabular storage",{"type":45,"value":60},": real tables inside the n8n instance with columns, types, rows, and CRUD via the ",{"type":39,"tag":62,"props":63,"children":65},"code",{"className":64},[],[66],{"type":45,"value":67},"dataTable",{"type":45,"value":69}," node and data-table MCP tools.",{"type":39,"tag":48,"props":71,"children":72},{},[73,75,81],{"type":45,"value":74},"Use them for local persistent state: lookup tables, recent events, per-session inventories, counters, idempotency tracking, dedup state when there's row-level logic or external visibility (plain \"have I seen this value?\" dedup belongs in the ",{"type":39,"tag":62,"props":76,"children":78},{"className":77},[],[79],{"type":45,"value":80},"Remove Duplicates",{"type":45,"value":82}," node). Small-to-moderate volume (tens of thousands of rows fine, millions belong in a real DB).",{"type":39,"tag":84,"props":85,"children":87},"h2",{"id":86},"non-negotiables",[88],{"type":45,"value":89},"Non-negotiables",{"type":39,"tag":91,"props":92,"children":93},"ol",{},[94,137],{"type":39,"tag":95,"props":96,"children":97},"li",{},[98,103,105,111,113,119,121,127,129,135],{"type":39,"tag":54,"props":99,"children":100},{},[101],{"type":45,"value":102},"System-managed columns + external IDs.",{"type":45,"value":104}," Three columns auto-exist on every table: ",{"type":39,"tag":62,"props":106,"children":108},{"className":107},[],[109],{"type":45,"value":110},"id",{"type":45,"value":112}," (bigserial), ",{"type":39,"tag":62,"props":114,"children":116},{"className":115},[],[117],{"type":45,"value":118},"createdAt",{"type":45,"value":120},", ",{"type":39,"tag":62,"props":122,"children":124},{"className":123},[],[125],{"type":45,"value":126},"updatedAt",{"type":45,"value":128},". Don't declare them in ",{"type":39,"tag":62,"props":130,"children":132},{"className":131},[],[133],{"type":45,"value":134},"create_data_table",{"type":45,"value":136}," (errors or shadows the system column). Don't write them on insert. For domain identifiers from outside (arxivId, stripeCustomerId, requestId), add a separate column and key dedup\u002Flookup on that.",{"type":39,"tag":95,"props":138,"children":139},{},[140,161,163,168,170,176,178,184,186,191,193,199,201,207],{"type":39,"tag":54,"props":141,"children":142},{},[143,145,151,153,159],{"type":45,"value":144},"Only primitives in columns, nested data uses ",{"type":39,"tag":62,"props":146,"children":148},{"className":147},[],[149],{"type":45,"value":150},"string",{"type":45,"value":152}," + ",{"type":39,"tag":62,"props":154,"children":156},{"className":155},[],[157],{"type":45,"value":158},"_object",{"type":45,"value":160}," postfix.",{"type":45,"value":162}," No JSON\u002Fobject\u002Farray column types exist. For nested data (arrays, parsed objects), use a ",{"type":39,"tag":62,"props":164,"children":166},{"className":165},[],[167],{"type":45,"value":150},{"type":45,"value":169}," column with ",{"type":39,"tag":62,"props":171,"children":173},{"className":172},[],[174],{"type":45,"value":175},"JSON.stringify(...)",{"type":45,"value":177}," on write and ",{"type":39,"tag":62,"props":179,"children":181},{"className":180},[],[182],{"type":45,"value":183},"JSON.parse(...)",{"type":45,"value":185}," on read. Mark the column with ",{"type":39,"tag":62,"props":187,"children":189},{"className":188},[],[190],{"type":45,"value":158},{"type":45,"value":192}," (e.g., ",{"type":39,"tag":62,"props":194,"children":196},{"className":195},[],[197],{"type":45,"value":198},"keyInsights_object",{"type":45,"value":200},"). The postfix is the contract that tells readers to parse. See ",{"type":39,"tag":62,"props":202,"children":204},{"className":203},[],[205],{"type":45,"value":206},"references\u002FSCHEMA_DESIGN.md",{"type":45,"value":208},".",{"type":39,"tag":84,"props":210,"children":212},{"id":211},"strong-defaults",[213],{"type":45,"value":214},"Strong defaults",{"type":39,"tag":216,"props":217,"children":218},"ul",{},[219,237],{"type":39,"tag":95,"props":220,"children":221},{},[222,227,229,235],{"type":39,"tag":54,"props":223,"children":224},{},[225],{"type":45,"value":226},"Don't add a Set node before a Data Table node to modify fields.",{"type":45,"value":228}," The Data Table node's per-column expression slots are just as powerful as Set fields, so the Set node is doing zero work the Data Table node can't do itself. (Same Set-node antipattern called out in ",{"type":39,"tag":62,"props":230,"children":232},{"className":231},[],[233],{"type":45,"value":234},"n8n-expressions-official",{"type":45,"value":236},".)",{"type":39,"tag":95,"props":238,"children":239},{},[240,245,247,252,253,258,260,266,267,273,274,280,282,288,290,295,297,302],{"type":39,"tag":54,"props":241,"children":242},{},[243],{"type":45,"value":244},"Match n8n's column casing: camelCase.",{"type":45,"value":246}," The auto-managed columns are camelCase (",{"type":39,"tag":62,"props":248,"children":250},{"className":249},[],[251],{"type":45,"value":118},{"type":45,"value":120},{"type":39,"tag":62,"props":254,"children":256},{"className":255},[],[257],{"type":45,"value":126},{"type":45,"value":259},"), so user columns read more cleanly when they match: ",{"type":39,"tag":62,"props":261,"children":263},{"className":262},[],[264],{"type":45,"value":265},"arxivId",{"type":45,"value":120},{"type":39,"tag":62,"props":268,"children":270},{"className":269},[],[271],{"type":45,"value":272},"paperId",{"type":45,"value":120},{"type":39,"tag":62,"props":275,"children":277},{"className":276},[],[278],{"type":45,"value":279},"taxRate",{"type":45,"value":281},". Mixed casing in the same query (",{"type":39,"tag":62,"props":283,"children":285},{"className":284},[],[286],{"type":45,"value":287},"createdAt >= ... AND arxiv_id eq ...",{"type":45,"value":289},") reads as a typo. Keep the ",{"type":39,"tag":62,"props":291,"children":293},{"className":292},[],[294],{"type":45,"value":158},{"type":45,"value":296}," postfix on stringified-blob columns regardless (",{"type":39,"tag":62,"props":298,"children":300},{"className":299},[],[301],{"type":45,"value":198},{"type":45,"value":303},"), the underscore is a contract marker, not casing.",{"type":39,"tag":216,"props":305,"children":306},{},[307,333,364],{"type":39,"tag":95,"props":308,"children":309},{},[310,331],{"type":39,"tag":54,"props":311,"children":312},{},[313,315,321,323,329],{"type":45,"value":314},"Verify the ",{"type":39,"tag":62,"props":316,"children":318},{"className":317},[],[319],{"type":45,"value":320},"columns",{"type":45,"value":322}," parameter via ",{"type":39,"tag":62,"props":324,"children":326},{"className":325},[],[327],{"type":45,"value":328},"get_workflow_details",{"type":45,"value":330}," after create\u002Fupdate.",{"type":45,"value":332}," The UI has a display quirk in manual mapping mode (\"Currently no items exist\" with no actual data loss). Checking the JSON confirms what's persisted.",{"type":39,"tag":95,"props":334,"children":335},{},[336,341,343,348,350,355,356,362],{"type":39,"tag":54,"props":337,"children":338},{},[339],{"type":45,"value":340},"Relational design works when the shape calls for it.",{"type":45,"value":342}," For genuine parent-child data (papers → summaries, customers → orders), reference parents by ",{"type":39,"tag":62,"props":344,"children":346},{"className":345},[],[347],{"type":45,"value":110},{"type":45,"value":349},", name columns explicitly (",{"type":39,"tag":62,"props":351,"children":353},{"className":352},[],[354],{"type":45,"value":272},{"type":45,"value":120},{"type":39,"tag":62,"props":357,"children":359},{"className":358},[],[360],{"type":45,"value":361},"customerId",{"type":45,"value":363},"), and enforce integrity in workflow logic. Don't force it on flat use cases (dedup, lookup, audit) where there's no relationship to model.",{"type":39,"tag":95,"props":365,"children":366},{},[367,372,374,379,381,387,389,394],{"type":39,"tag":54,"props":368,"children":369},{},[370],{"type":45,"value":371},"Storage format is not interface format.",{"type":45,"value":373}," Parse ",{"type":39,"tag":62,"props":375,"children":377},{"className":376},[],[378],{"type":45,"value":158},{"type":45,"value":380}," fields ",{"type":39,"tag":382,"props":383,"children":384},"em",{},[385],{"type":45,"value":386},"before",{"type":45,"value":388}," returning them from a sub-workflow. Callers should never receive stringified shells they have to parse themselves. See ",{"type":39,"tag":62,"props":390,"children":392},{"className":391},[],[393],{"type":45,"value":206},{"type":45,"value":395}," \"Storage format ≠ interface format\".",{"type":39,"tag":84,"props":397,"children":399},{"id":398},"the-default-columns",[400],{"type":45,"value":401},"The default columns",{"type":39,"tag":48,"props":403,"children":404},{},[405],{"type":45,"value":406},"Every Data Table has these whether you declare them or not:",{"type":39,"tag":408,"props":409,"children":410},"table",{},[411,435],{"type":39,"tag":412,"props":413,"children":414},"thead",{},[415],{"type":39,"tag":416,"props":417,"children":418},"tr",{},[419,425,430],{"type":39,"tag":420,"props":421,"children":422},"th",{},[423],{"type":45,"value":424},"Column",{"type":39,"tag":420,"props":426,"children":427},{},[428],{"type":45,"value":429},"Type",{"type":39,"tag":420,"props":431,"children":432},{},[433],{"type":45,"value":434},"Behavior",{"type":39,"tag":436,"props":437,"children":438},"tbody",{},[439,461,482],{"type":39,"tag":416,"props":440,"children":441},{},[442,451,456],{"type":39,"tag":443,"props":444,"children":445},"td",{},[446],{"type":39,"tag":62,"props":447,"children":449},{"className":448},[],[450],{"type":45,"value":110},{"type":39,"tag":443,"props":452,"children":453},{},[454],{"type":45,"value":455},"bigserial \u002F number",{"type":39,"tag":443,"props":457,"children":458},{},[459],{"type":45,"value":460},"Auto-incrementing primary key. n8n assigns on insert, and you can't write to it. Returned in the insert response.",{"type":39,"tag":416,"props":462,"children":463},{},[464,472,477],{"type":39,"tag":443,"props":465,"children":466},{},[467],{"type":39,"tag":62,"props":468,"children":470},{"className":469},[],[471],{"type":45,"value":118},{"type":39,"tag":443,"props":473,"children":474},{},[475],{"type":45,"value":476},"timestamp",{"type":39,"tag":443,"props":478,"children":479},{},[480],{"type":45,"value":481},"Set automatically on insert.",{"type":39,"tag":416,"props":483,"children":484},{},[485,493,497],{"type":39,"tag":443,"props":486,"children":487},{},[488],{"type":39,"tag":62,"props":489,"children":491},{"className":490},[],[492],{"type":45,"value":126},{"type":39,"tag":443,"props":494,"children":495},{},[496],{"type":45,"value":476},{"type":39,"tag":443,"props":498,"children":499},{},[500],{"type":45,"value":501},"Refreshed automatically on each update.",{"type":39,"tag":48,"props":503,"children":504},{},[505],{"type":45,"value":506},"In practice:",{"type":39,"tag":216,"props":508,"children":509},{},[510,527,552],{"type":39,"tag":95,"props":511,"children":512},{},[513,518,520,525],{"type":39,"tag":54,"props":514,"children":515},{},[516],{"type":45,"value":517},"Don't declare them",{"type":45,"value":519}," in ",{"type":39,"tag":62,"props":521,"children":523},{"className":522},[],[524],{"type":45,"value":134},{"type":45,"value":526},". Already there.",{"type":39,"tag":95,"props":528,"children":529},{},[530,535,537,543,545,551],{"type":39,"tag":54,"props":531,"children":532},{},[533],{"type":45,"value":534},"Use them in queries",{"type":45,"value":536}," without your own timestamp columns. \"Created today\": ",{"type":39,"tag":62,"props":538,"children":540},{"className":539},[],[541],{"type":45,"value":542},"createdAt >= '\u003Ctoday ISO>'",{"type":45,"value":544},". \"Updated since last sync\": ",{"type":39,"tag":62,"props":546,"children":548},{"className":547},[],[549],{"type":45,"value":550},"updatedAt >= $('Last Sync').item.json.timestamp",{"type":45,"value":208},{"type":39,"tag":95,"props":553,"children":554},{},[555,560,562,567],{"type":39,"tag":54,"props":556,"children":557},{},[558],{"type":45,"value":559},"Don't use them as cross-system identifiers.",{"type":45,"value":561}," Auto-",{"type":39,"tag":62,"props":563,"children":565},{"className":564},[],[566],{"type":45,"value":110},{"type":45,"value":568}," is internal, and resets on table recreate or instance migration. For domain identifiers, use your own column.",{"type":39,"tag":84,"props":570,"children":572},{"id":571},"relational-design-when-the-shape-calls-for-it",[573],{"type":45,"value":574},"Relational design when the shape calls for it",{"type":39,"tag":48,"props":576,"children":577},{},[578],{"type":45,"value":579},"Data Tables don't enforce foreign keys, but you can still model parent-child data across tables when the data genuinely has that shape. The catch: integrity is your responsibility, not n8n's.",{"type":39,"tag":216,"props":581,"children":582},{},[583,606,636,646],{"type":39,"tag":95,"props":584,"children":585},{},[586,597,599,604],{"type":39,"tag":54,"props":587,"children":588},{},[589,591,596],{"type":45,"value":590},"Reference parent rows by ",{"type":39,"tag":62,"props":592,"children":594},{"className":593},[],[595],{"type":45,"value":110},{"type":45,"value":208},{"type":45,"value":598}," A child table holds the parent's ",{"type":39,"tag":62,"props":600,"children":602},{"className":601},[],[603],{"type":45,"value":110},{"type":45,"value":605}," in a column.",{"type":39,"tag":95,"props":607,"children":608},{},[609,614,616,621,622,627,628,634],{"type":39,"tag":54,"props":610,"children":611},{},[612],{"type":45,"value":613},"Document references in column names.",{"type":45,"value":615}," ",{"type":39,"tag":62,"props":617,"children":619},{"className":618},[],[620],{"type":45,"value":272},{"type":45,"value":120},{"type":39,"tag":62,"props":623,"children":625},{"className":624},[],[626],{"type":45,"value":361},{"type":45,"value":120},{"type":39,"tag":62,"props":629,"children":631},{"className":630},[],[632],{"type":45,"value":633},"eventId",{"type":45,"value":635}," make the relationship obvious.",{"type":39,"tag":95,"props":637,"children":638},{},[639,644],{"type":39,"tag":54,"props":640,"children":641},{},[642],{"type":45,"value":643},"Enforce integrity in workflow logic.",{"type":45,"value":645}," Before inserting a child, look up the parent. Before deleting a parent, decide what happens to children (delete, orphan, archive). n8n won't cascade.",{"type":39,"tag":95,"props":647,"children":648},{},[649,654],{"type":39,"tag":54,"props":650,"children":651},{},[652],{"type":45,"value":653},"Watch for stale references.",{"type":45,"value":655}," Children pointing at deleted parents are silent bugs. Soft-delete, or run cleanup workflows.",{"type":39,"tag":48,"props":657,"children":658},{},[659],{"type":45,"value":660},"For complex relational structure (3+ tables with joins, transactional writes), reach for an actual SQL DB.",{"type":39,"tag":84,"props":662,"children":664},{"id":663},"operations-which-one-for-what",[665],{"type":45,"value":666},"Operations: which one for what",{"type":39,"tag":408,"props":668,"children":669},{},[670,686],{"type":39,"tag":412,"props":671,"children":672},{},[673],{"type":39,"tag":416,"props":674,"children":675},{},[676,681],{"type":39,"tag":420,"props":677,"children":678},{},[679],{"type":45,"value":680},"Operation",{"type":39,"tag":420,"props":682,"children":683},{},[684],{"type":45,"value":685},"When",{"type":39,"tag":436,"props":687,"children":688},{},[689,712,737,754,792,809],{"type":39,"tag":416,"props":690,"children":691},{},[692,701],{"type":39,"tag":443,"props":693,"children":694},{},[695],{"type":39,"tag":62,"props":696,"children":698},{"className":697},[],[699],{"type":45,"value":700},"insert",{"type":39,"tag":443,"props":702,"children":703},{},[704,706,711],{"type":45,"value":705},"Always-add. New row, n8n assigns ",{"type":39,"tag":62,"props":707,"children":709},{"className":708},[],[710],{"type":45,"value":110},{"type":45,"value":208},{"type":39,"tag":416,"props":713,"children":714},{},[715,724],{"type":39,"tag":443,"props":716,"children":717},{},[718],{"type":39,"tag":62,"props":719,"children":721},{"className":720},[],[722],{"type":45,"value":723},"upsert",{"type":39,"tag":443,"props":725,"children":726},{},[727,729,735],{"type":45,"value":728},"\"Add if new, update if exists.\" Needs a ",{"type":39,"tag":62,"props":730,"children":732},{"className":731},[],[733],{"type":45,"value":734},"matchType",{"type":45,"value":736}," and filter to decide existence.",{"type":39,"tag":416,"props":738,"children":739},{},[740,749],{"type":39,"tag":443,"props":741,"children":742},{},[743],{"type":39,"tag":62,"props":744,"children":746},{"className":745},[],[747],{"type":45,"value":748},"update",{"type":39,"tag":443,"props":750,"children":751},{},[752],{"type":45,"value":753},"\"Modify rows matching this filter.\" No insert if no match.",{"type":39,"tag":416,"props":755,"children":756},{},[757,766],{"type":39,"tag":443,"props":758,"children":759},{},[760],{"type":39,"tag":62,"props":761,"children":763},{"className":762},[],[764],{"type":45,"value":765},"get",{"type":39,"tag":443,"props":767,"children":768},{},[769,771,777,778,784,785,791],{"type":45,"value":770},"Fetch rows matching a filter (returns 0+). Supports ",{"type":39,"tag":62,"props":772,"children":774},{"className":773},[],[775],{"type":45,"value":776},"orderBy",{"type":45,"value":120},{"type":39,"tag":62,"props":779,"children":781},{"className":780},[],[782],{"type":45,"value":783},"limit",{"type":45,"value":120},{"type":39,"tag":62,"props":786,"children":788},{"className":787},[],[789],{"type":45,"value":790},"returnAll",{"type":45,"value":208},{"type":39,"tag":416,"props":793,"children":794},{},[795,804],{"type":39,"tag":443,"props":796,"children":797},{},[798],{"type":39,"tag":62,"props":799,"children":801},{"className":800},[],[802],{"type":45,"value":803},"deleteRows",{"type":39,"tag":443,"props":805,"children":806},{},[807],{"type":45,"value":808},"Remove rows matching a filter.",{"type":39,"tag":416,"props":810,"children":811},{},[812,829],{"type":39,"tag":443,"props":813,"children":814},{},[815,821,823],{"type":39,"tag":62,"props":816,"children":818},{"className":817},[],[819],{"type":45,"value":820},"rowExists",{"type":45,"value":822}," \u002F ",{"type":39,"tag":62,"props":824,"children":826},{"className":825},[],[827],{"type":45,"value":828},"rowNotExists",{"type":39,"tag":443,"props":830,"children":831},{},[832],{"type":45,"value":833},"Boolean-style filter against incoming items. Common for dedup branching.",{"type":39,"tag":48,"props":835,"children":836},{},[837,839,845],{"type":45,"value":838},"For the full operation surface (filter syntax, matchType, sort patterns), see ",{"type":39,"tag":62,"props":840,"children":842},{"className":841},[],[843],{"type":45,"value":844},"references\u002FOPERATIONS.md",{"type":45,"value":208},{"type":39,"tag":84,"props":847,"children":849},{"id":848},"the-currently-no-items-exist-ui-quirk",[850],{"type":45,"value":851},"The \"Currently no items exist\" UI quirk",{"type":39,"tag":48,"props":853,"children":854},{},[855,857,863],{"type":45,"value":856},"When the SDK saves manual-mode column mappings (",{"type":39,"tag":62,"props":858,"children":860},{"className":859},[],[861],{"type":45,"value":862},"mappingMode: 'defineBelow'",{"type":45,"value":864},"), the n8n UI's \"Values to insert\" pane can render empty (\"Currently no items exist\") even though runtime persists data correctly. If the user reports the Insert node \"looks broken\" or \"has no fields,\" tell them: it's a UI display issue, press the reload (refresh) button on the columns parameter, and it repopulates the schema and the mappings render. No data loss, safe to do anytime.",{"type":39,"tag":84,"props":866,"children":868},{"id":867},"common-patterns",[869],{"type":45,"value":870},"Common patterns",{"type":39,"tag":872,"props":873,"children":875},"h3",{"id":874},"dedup-by-external-id",[876],{"type":45,"value":877},"Dedup by external ID",{"type":39,"tag":48,"props":879,"children":880},{},[881,883,888],{"type":45,"value":882},"Default to the ",{"type":39,"tag":62,"props":884,"children":886},{"className":885},[],[887],{"type":45,"value":80},{"type":45,"value":889}," node (\"items seen in previous executions\" mode) for plain \"have I seen this value?\" dedup. It's a one-node solution with an internal store, no schema to maintain. Data Tables only earn the slot when there's a reason for the dedup state to live in a real table:",{"type":39,"tag":216,"props":891,"children":892},{},[893,903,913],{"type":39,"tag":95,"props":894,"children":895},{},[896,901],{"type":39,"tag":54,"props":897,"children":898},{},[899],{"type":45,"value":900},"You'll query or inspect the dedup state.",{"type":45,"value":902}," Dashboards, audit, \"what have we processed in the last week?\"",{"type":39,"tag":95,"props":904,"children":905},{},[906,911],{"type":39,"tag":54,"props":907,"children":908},{},[909],{"type":45,"value":910},"Row-level logic on hits.",{"type":45,"value":912}," Per-category TTL (\"expire after 30 days for category A, 7 days for category B\"), conditional re-process based on stored state, branching on a status column.",{"type":39,"tag":95,"props":914,"children":915},{},[916,921,923,928],{"type":39,"tag":54,"props":917,"children":918},{},[919],{"type":45,"value":920},"Per-tenant or per-user namespacing",{"type":45,"value":922}," that the ",{"type":39,"tag":62,"props":924,"children":926},{"className":925},[],[927],{"type":45,"value":80},{"type":45,"value":929}," history-store can't express.",{"type":39,"tag":48,"props":931,"children":932},{},[933],{"type":45,"value":934},"When that bar is met:",{"type":39,"tag":936,"props":937,"children":941},"pre",{"className":938,"code":940,"language":45},[939],"language-text","[Source: { arxivId, ... }]\n   ↓\n[Data Table Get: filter arxivId eq $json.arxivId, limit 1]\n   ↓\n[IF: result has items?]\n   ├── Yes → [Skip, or apply row-level logic from the stored row]\n   └── No  → [Process] → [Data Table Insert: { arxivId, ...rest }]\n",[942],{"type":39,"tag":62,"props":943,"children":945},{"__ignoreMap":944},"",[946],{"type":45,"value":940},{"type":39,"tag":48,"props":948,"children":949},{},[950,952,958],{"type":45,"value":951},"For the full pattern surface (upsert, rowNotExists, Get+IF, idempotency keys), see ",{"type":39,"tag":62,"props":953,"children":955},{"className":954},[],[956],{"type":45,"value":957},"references\u002FDEDUP_PATTERNS.md",{"type":45,"value":208},{"type":39,"tag":872,"props":960,"children":962},{"id":961},"lookup-tables",[963],{"type":45,"value":964},"Lookup tables",{"type":39,"tag":48,"props":966,"children":967},{},[968],{"type":45,"value":969},"Stable reference data (country → tax rate, plan → feature flags). Edited via n8n UI, and workflows read at execution:",{"type":39,"tag":936,"props":971,"children":974},{"className":972,"code":973,"language":45},[939],"[Data Table Get: filter country eq $json.country, limit 1]\n   ↓\n[Use the looked-up row's taxRate, etc.]\n",[975],{"type":39,"tag":62,"props":976,"children":977},{"__ignoreMap":944},[978],{"type":45,"value":973},{"type":39,"tag":872,"props":980,"children":982},{"id":981},"recent-events-audit-trail",[983],{"type":45,"value":984},"Recent events \u002F audit trail",{"type":39,"tag":48,"props":986,"children":987},{},[988],{"type":45,"value":989},"Append-only insert, queried later:",{"type":39,"tag":936,"props":991,"children":994},{"className":992,"code":993,"language":45},[939],"[Workflow event] → [Data Table Insert: { userId, eventType, payloadSummary }]\n",[995],{"type":39,"tag":62,"props":996,"children":997},{"__ignoreMap":944},[998],{"type":45,"value":993},{"type":39,"tag":48,"props":1000,"children":1001},{},[1002,1007],{"type":39,"tag":62,"props":1003,"children":1005},{"className":1004},[],[1006],{"type":45,"value":118},{"type":45,"value":1008}," makes \"recent events in the last hour\" trivial without your own timestamp.",{"type":39,"tag":84,"props":1010,"children":1012},{"id":1011},"reference-files",[1013],{"type":45,"value":1014},"Reference files",{"type":39,"tag":408,"props":1016,"children":1017},{},[1018,1034],{"type":39,"tag":412,"props":1019,"children":1020},{},[1021],{"type":39,"tag":416,"props":1022,"children":1023},{},[1024,1029],{"type":39,"tag":420,"props":1025,"children":1026},{},[1027],{"type":45,"value":1028},"File",{"type":39,"tag":420,"props":1030,"children":1031},{},[1032],{"type":45,"value":1033},"Read when",{"type":39,"tag":436,"props":1035,"children":1036},{},[1037,1069,1085],{"type":39,"tag":416,"props":1038,"children":1039},{},[1040,1048],{"type":39,"tag":443,"props":1041,"children":1042},{},[1043],{"type":39,"tag":62,"props":1044,"children":1046},{"className":1045},[],[1047],{"type":45,"value":206},{"type":39,"tag":443,"props":1049,"children":1050},{},[1051,1053,1059,1061,1067],{"type":45,"value":1052},"Designing columns\u002Ftypes, the no-FK relational pattern, mapping mode (",{"type":39,"tag":62,"props":1054,"children":1056},{"className":1055},[],[1057],{"type":45,"value":1058},"defineBelow",{"type":45,"value":1060}," vs ",{"type":39,"tag":62,"props":1062,"children":1064},{"className":1063},[],[1065],{"type":45,"value":1066},"autoMapInputData",{"type":45,"value":1068},"), when Data Tables are the wrong tool",{"type":39,"tag":416,"props":1070,"children":1071},{},[1072,1080],{"type":39,"tag":443,"props":1073,"children":1074},{},[1075],{"type":39,"tag":62,"props":1076,"children":1078},{"className":1077},[],[1079],{"type":45,"value":844},{"type":39,"tag":443,"props":1081,"children":1082},{},[1083],{"type":45,"value":1084},"Operation surface (insert\u002Fupsert\u002Fupdate\u002Fget\u002Fdelete\u002FrowExists), filter syntax, matchType, orderBy",{"type":39,"tag":416,"props":1086,"children":1087},{},[1088,1096],{"type":39,"tag":443,"props":1089,"children":1090},{},[1091],{"type":39,"tag":62,"props":1092,"children":1094},{"className":1093},[],[1095],{"type":45,"value":957},{"type":39,"tag":443,"props":1097,"children":1098},{},[1099],{"type":45,"value":1100},"Idempotency keys, RemoveDuplicates node vs Data Table dedup, search-then-insert vs upsert",{"type":39,"tag":48,"props":1102,"children":1103},{},[1104,1106,1112,1113,1119,1121,1126,1128,1134,1135,1141],{"type":45,"value":1105},"For expression discipline (",{"type":39,"tag":62,"props":1107,"children":1109},{"className":1108},[],[1110],{"type":45,"value":1111},"$json",{"type":45,"value":1060},{"type":39,"tag":62,"props":1114,"children":1116},{"className":1115},[],[1117],{"type":45,"value":1118},"$('Node Name').item.json",{"type":45,"value":1120},", the Set-node antipattern), see ",{"type":39,"tag":62,"props":1122,"children":1124},{"className":1123},[],[1125],{"type":45,"value":234},{"type":45,"value":1127},". For Merge convergence and same-shape branches, see ",{"type":39,"tag":62,"props":1129,"children":1131},{"className":1130},[],[1132],{"type":45,"value":1133},"n8n-node-configuration-official",{"type":45,"value":615},{"type":39,"tag":62,"props":1136,"children":1138},{"className":1137},[],[1139],{"type":45,"value":1140},"references\u002FMERGE_NODE.md",{"type":45,"value":208},{"type":39,"tag":84,"props":1143,"children":1145},{"id":1144},"anti-patterns",[1146],{"type":45,"value":1147},"Anti-patterns",{"type":39,"tag":408,"props":1149,"children":1150},{},[1151,1172],{"type":39,"tag":412,"props":1152,"children":1153},{},[1154],{"type":39,"tag":416,"props":1155,"children":1156},{},[1157,1162,1167],{"type":39,"tag":420,"props":1158,"children":1159},{},[1160],{"type":45,"value":1161},"Anti-pattern",{"type":39,"tag":420,"props":1163,"children":1164},{},[1165],{"type":45,"value":1166},"What goes wrong",{"type":39,"tag":420,"props":1168,"children":1169},{},[1170],{"type":45,"value":1171},"Fix",{"type":39,"tag":436,"props":1173,"children":1174},{},[1175,1193,1234,1252,1270,1309,1327,1365],{"type":39,"tag":416,"props":1176,"children":1177},{},[1178,1183,1188],{"type":39,"tag":443,"props":1179,"children":1180},{},[1181],{"type":45,"value":1182},"Set node upstream of Insert \"to shape the input\"",{"type":39,"tag":443,"props":1184,"children":1185},{},[1186],{"type":45,"value":1187},"Extra node for nothing, classic Set antipattern, field shape drifts when you add columns",{"type":39,"tag":443,"props":1189,"children":1190},{},[1191],{"type":45,"value":1192},"Map directly in the Insert node's per-column slots, OR rename upstream fields to enable auto-map",{"type":39,"tag":416,"props":1194,"children":1195},{},[1196,1224,1229],{"type":39,"tag":443,"props":1197,"children":1198},{},[1199,1201,1206,1207,1212,1213,1218,1219],{"type":45,"value":1200},"Declaring ",{"type":39,"tag":62,"props":1202,"children":1204},{"className":1203},[],[1205],{"type":45,"value":110},{"type":45,"value":120},{"type":39,"tag":62,"props":1208,"children":1210},{"className":1209},[],[1211],{"type":45,"value":118},{"type":45,"value":120},{"type":39,"tag":62,"props":1214,"children":1216},{"className":1215},[],[1217],{"type":45,"value":126},{"type":45,"value":519},{"type":39,"tag":62,"props":1220,"children":1222},{"className":1221},[],[1223],{"type":45,"value":134},{"type":39,"tag":443,"props":1225,"children":1226},{},[1227],{"type":45,"value":1228},"Errors, or shadows the system column with a user column that doesn't auto-update",{"type":39,"tag":443,"props":1230,"children":1231},{},[1232],{"type":45,"value":1233},"Don't declare them, they're already there",{"type":39,"tag":416,"props":1235,"children":1236},{},[1237,1242,1247],{"type":39,"tag":443,"props":1238,"children":1239},{},[1240],{"type":45,"value":1241},"Storing application-critical data in Data Tables",{"type":39,"tag":443,"props":1243,"children":1244},{},[1245],{"type":45,"value":1246},"If n8n breaks, you lose access",{"type":39,"tag":443,"props":1248,"children":1249},{},[1250],{"type":45,"value":1251},"Use a real DB for data you can't lose",{"type":39,"tag":416,"props":1253,"children":1254},{},[1255,1260,1265],{"type":39,"tag":443,"props":1256,"children":1257},{},[1258],{"type":45,"value":1259},"Cross-app system-of-record in Data Tables",{"type":39,"tag":443,"props":1261,"children":1262},{},[1263],{"type":45,"value":1264},"Hard to share with non-n8n consumers, awkward query surface",{"type":39,"tag":443,"props":1266,"children":1267},{},[1268],{"type":45,"value":1269},"Use a real DB",{"type":39,"tag":416,"props":1271,"children":1272},{},[1273,1285,1290],{"type":39,"tag":443,"props":1274,"children":1275},{},[1276,1278,1283],{"type":45,"value":1277},"Treating auto-",{"type":39,"tag":62,"props":1279,"children":1281},{"className":1280},[],[1282],{"type":45,"value":110},{"type":45,"value":1284}," as a stable cross-instance identifier",{"type":39,"tag":443,"props":1286,"children":1287},{},[1288],{"type":45,"value":1289},"Resets if the table is recreated, not portable",{"type":39,"tag":443,"props":1291,"children":1292},{},[1293,1295,1300,1301,1307],{"type":45,"value":1294},"Use a domain ID column (",{"type":39,"tag":62,"props":1296,"children":1298},{"className":1297},[],[1299],{"type":45,"value":265},{"type":45,"value":120},{"type":39,"tag":62,"props":1302,"children":1304},{"className":1303},[],[1305],{"type":45,"value":1306},"requestId",{"type":45,"value":1308},") for cross-system references",{"type":39,"tag":416,"props":1310,"children":1311},{},[1312,1317,1322],{"type":39,"tag":443,"props":1313,"children":1314},{},[1315],{"type":45,"value":1316},"Foreign-key cascade assumptions",{"type":39,"tag":443,"props":1318,"children":1319},{},[1320],{"type":45,"value":1321},"n8n doesn't cascade, deleted parents leave orphan children",{"type":39,"tag":443,"props":1323,"children":1324},{},[1325],{"type":45,"value":1326},"Soft-delete, or run cleanup workflows that maintain referential integrity",{"type":39,"tag":416,"props":1328,"children":1329},{},[1330,1335,1340],{"type":39,"tag":443,"props":1331,"children":1332},{},[1333],{"type":45,"value":1334},"Referencing an immediately-prior node when an intermediate stripped json",{"type":39,"tag":443,"props":1336,"children":1337},{},[1338],{"type":45,"value":1339},"Insert silently writes NULLs for fields that \"should be there\"",{"type":39,"tag":443,"props":1341,"children":1342},{},[1343,1345,1350,1352,1357,1358,1363],{"type":45,"value":1344},"Reference a stable upstream node by name, or use a NoOp\u002FMerge convergence anchor (see ",{"type":39,"tag":62,"props":1346,"children":1348},{"className":1347},[],[1349],{"type":45,"value":234},{"type":45,"value":1351}," and ",{"type":39,"tag":62,"props":1353,"children":1355},{"className":1354},[],[1356],{"type":45,"value":1133},{"type":45,"value":615},{"type":39,"tag":62,"props":1359,"children":1361},{"className":1360},[],[1362],{"type":45,"value":1140},{"type":45,"value":1364},")",{"type":39,"tag":416,"props":1366,"children":1367},{},[1368,1373,1378],{"type":39,"tag":443,"props":1369,"children":1370},{},[1371],{"type":45,"value":1372},"Manual-map mode + Set node to fix \"Currently no items exist\"",{"type":39,"tag":443,"props":1374,"children":1375},{},[1376],{"type":45,"value":1377},"Doesn't fix anything, that's a UI quirk, you've added a useless Set node",{"type":39,"tag":443,"props":1379,"children":1380},{},[1381,1383,1388,1390,1396],{"type":45,"value":1382},"Verify via ",{"type":39,"tag":62,"props":1384,"children":1386},{"className":1385},[],[1387],{"type":45,"value":328},{"type":45,"value":1389}," that ",{"type":39,"tag":62,"props":1391,"children":1393},{"className":1392},[],[1394],{"type":45,"value":1395},"columns.value",{"type":45,"value":1397}," has your mappings, runtime is fine. Tell the user to press the reload button on the columns parameter to make the UI render the fields.",{"type":39,"tag":84,"props":1399,"children":1401},{"id":1400},"verification-before-publishing",[1402],{"type":45,"value":1403},"Verification before publishing",{"type":39,"tag":48,"props":1405,"children":1406},{},[1407],{"type":45,"value":1408},"After creating or updating a workflow that uses Data Tables:",{"type":39,"tag":91,"props":1410,"children":1411},{},[1412,1423,1456,1485],{"type":39,"tag":95,"props":1413,"children":1414},{},[1415,1421],{"type":39,"tag":62,"props":1416,"children":1418},{"className":1417},[],[1419],{"type":45,"value":1420},"validate_workflow",{"type":45,"value":1422}," passes.",{"type":39,"tag":95,"props":1424,"children":1425},{},[1426,1431,1433,1438,1440,1446,1448,1454],{"type":39,"tag":62,"props":1427,"children":1429},{"className":1428},[],[1430],{"type":45,"value":328},{"type":45,"value":1432}," and inspect each Data Table node's ",{"type":39,"tag":62,"props":1434,"children":1436},{"className":1435},[],[1437],{"type":45,"value":320},{"type":45,"value":1439},". Both ",{"type":39,"tag":62,"props":1441,"children":1443},{"className":1442},[],[1444],{"type":45,"value":1445},"value",{"type":45,"value":1447}," and (for manual map) ",{"type":39,"tag":62,"props":1449,"children":1451},{"className":1450},[],[1452],{"type":45,"value":1453},"schema",{"type":45,"value":1455}," populated.",{"type":39,"tag":95,"props":1457,"children":1458},{},[1459,1465,1467,1472,1473,1478,1479,1484],{"type":39,"tag":62,"props":1460,"children":1462},{"className":1461},[],[1463],{"type":45,"value":1464},"test_workflow",{"type":45,"value":1466}," with pinned data. Insert response should include ",{"type":39,"tag":62,"props":1468,"children":1470},{"className":1469},[],[1471],{"type":45,"value":110},{"type":45,"value":120},{"type":39,"tag":62,"props":1474,"children":1476},{"className":1475},[],[1477],{"type":45,"value":118},{"type":45,"value":120},{"type":39,"tag":62,"props":1480,"children":1482},{"className":1481},[],[1483],{"type":45,"value":126},{"type":45,"value":208},{"type":39,"tag":95,"props":1486,"children":1487},{},[1488],{"type":45,"value":1489},"Inspect actual Data Table contents via UI or follow-up Get to confirm columns aren't silently NULL.",{"type":39,"tag":48,"props":1491,"children":1492},{},[1493],{"type":45,"value":1494},"Step 4 especially the first time you wire a new Insert. Context-stripping intermediates + manual map + UI quirk silently produce NULL columns.",{"items":1496,"total":1650},[1497,1514,1531,1542,1554,1567,1580,1597,1606,1618,1628,1638],{"slug":1498,"name":1498,"fn":1499,"description":1500,"org":1501,"tags":1502,"stars":1511,"repoUrl":1512,"updatedAt":1513},"config-evals","configure workflow evaluations","Builds and maintains configuration-based evaluations on a workflow with the eval-config tool. Use when the user asks to set up, add, view, change, or remove an evaluation, score, grade, or judge a workflow's output, or measure answer quality against a test dataset. This is the only eval form Instance AI handles — it does not touch on-canvas evaluation nodes.",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1503,1506,1507,1510],{"name":1504,"slug":1505,"type":13},"Evals","evals",{"name":8,"slug":8,"type":13},{"name":1508,"slug":1509,"type":13},"Testing","testing",{"name":21,"slug":22,"type":13},198156,"https:\u002F\u002Fgithub.com\u002Fn8n-io\u002Fn8n","2026-07-24T05:37:07.398695",{"slug":1515,"name":1515,"fn":1516,"description":1517,"org":1518,"tags":1519,"stars":1511,"repoUrl":1512,"updatedAt":1530},"credential-setup-with-computer-use","configure n8n credentials via browser","Guides n8n credential setup through Computer Use browser tools. Use when a user needs OAuth apps, API keys, client IDs, client secrets, or other credential values from an external service console.",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1520,1523,1526,1527],{"name":1521,"slug":1522,"type":13},"Automation","automation",{"name":1524,"slug":1525,"type":13},"Configuration","configuration",{"name":8,"slug":8,"type":13},{"name":1528,"slug":1529,"type":13},"OAuth","oauth","2026-06-30T07:40:45.54",{"slug":1532,"name":1532,"fn":5,"description":1533,"org":1534,"tags":1535,"stars":1511,"repoUrl":1512,"updatedAt":1541},"data-table-manager","Load before calling data-tables or parse-file. Use for natural standalone requests like \"what data tables do I have?\", \"show\u002Flist my tables\", or \"what columns are in this table?\", and whenever the user asks to list, show, create, inspect, import, seed, query, update, clean up, rename columns in, or delete data tables and rows, especially from CSV\u002FXLSX\u002FJSON attachments. Also load before building or planning workflows that create or write to Data Tables (then load workflow-builder before build-workflow).",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1536,1539,1540],{"name":1537,"slug":1538,"type":13},"Data Engineering","data-engineering",{"name":15,"slug":16,"type":13},{"name":8,"slug":8,"type":13},"2026-07-27T06:07:14.648144",{"slug":1543,"name":1543,"fn":1544,"description":1545,"org":1546,"tags":1547,"stars":1511,"repoUrl":1512,"updatedAt":1530},"debugging-executions","debug failed n8n workflow executions","Debug failed or wrong-output workflow executions using executions tools. Load when the user reports execution failures, unexpected node output, empty parameter values after a successful run, or a node showing a red or failed expression error.",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1548,1549,1552,1553],{"name":1521,"slug":1522,"type":13},{"name":1550,"slug":1551,"type":13},"Debugging","debugging",{"name":8,"slug":8,"type":13},{"name":21,"slug":22,"type":13},{"slug":1555,"name":1555,"fn":1556,"description":1557,"org":1558,"tags":1559,"stars":1511,"repoUrl":1512,"updatedAt":1566},"intent-recognition","classify automation requests by control flow","Classifies automation requests using two decisions: anchor (which primitive owns the top-level control flow — workflow-anchored, agent-anchored, needs-clarification, or out-of-scope) and embeds_other (whether the other primitive appears embedded inside — an agent step inside a workflow, or a workflow invoked as an agent tool). Must be used before deciding the intent of any automation request, including compound requests with multiple independent automations, mid-build extensions to an existing workflow or agent, one-off questions or reports that need external systems you cannot query directly, and requests that need clarification before an anchor can be chosen, before choosing workflow-builder, planning, or an agent-oriented design.",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1560,1563,1564,1565],{"name":1561,"slug":1562,"type":13},"Agents","agents",{"name":1521,"slug":1522,"type":13},{"name":8,"slug":8,"type":13},{"name":21,"slug":22,"type":13},"2026-07-30T05:30:06.772347",{"slug":1568,"name":1568,"fn":1569,"description":1570,"org":1571,"tags":1572,"stars":1511,"repoUrl":1512,"updatedAt":1579},"n8n-cli","manage n8n workflows from the CLI","Use the n8n CLI to manage workflows, credentials, executions, and more on an n8n instance. Use when the user asks to interact with n8n, automate workflows, manage credentials, or operate their instance from the command line.",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1573,1574,1577,1578],{"name":1521,"slug":1522,"type":13},{"name":1575,"slug":1576,"type":13},"CLI","cli",{"name":8,"slug":8,"type":13},{"name":21,"slug":22,"type":13},"2026-04-06T18:38:40.360123",{"slug":1581,"name":1581,"fn":1582,"description":1583,"org":1584,"tags":1585,"stars":1511,"repoUrl":1512,"updatedAt":1596},"n8n-docs-assistant","retrieve n8n documentation and guidance","Answers n8n product, setup, credential, node, hosting, API, and usage questions from current n8n docs. Load n8n-docs via load_tool before calling it (search \"n8n docs\" if not visible). Use when the user asks how to configure, set up, troubleshoot, or understand n8n behavior, especially credential setup questions opened from the credential modal.",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1586,1589,1590,1593],{"name":1587,"slug":1588,"type":13},"Documentation","documentation",{"name":8,"slug":8,"type":13},{"name":1591,"slug":1592,"type":13},"Reference","reference",{"name":1594,"slug":1595,"type":13},"Search","search","2026-07-27T06:07:15.692906",{"slug":1598,"name":1598,"fn":1599,"description":1600,"org":1601,"tags":1602,"stars":1511,"repoUrl":1512,"updatedAt":1530},"planned-task-runtime","manage n8n task runtimes","Handles system follow-up turns: planned-task-follow-up (synthesize, replan, build-workflow, checkpoint), background-task-completed, running-tasks context, and create-tasks silence rules. Load whenever any of these tags appear or after calling create-tasks.",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1603,1604,1605],{"name":1521,"slug":1522,"type":13},{"name":8,"slug":8,"type":13},{"name":21,"slug":22,"type":13},{"slug":1607,"name":1607,"fn":1608,"description":1609,"org":1610,"tags":1611,"stars":1511,"repoUrl":1512,"updatedAt":1617},"planning","coordinate multi-artifact workflows","ONLY for coordinated multi-artifact work: multiple workflows with dependencies, shared data-table schema\u002Fmigration across tasks, or the user explicitly asked to review a plan first. Load create-tasks via load_tool before calling it (search \"create tasks\" if not visible). Do NOT use for new one-off workflows, single-workflow edits, verification-only requests, or standalone data-table ops — use workflow-builder or data-table-manager instead.",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1612,1613,1614,1616],{"name":1521,"slug":1522,"type":13},{"name":8,"slug":8,"type":13},{"name":1615,"slug":1607,"type":13},"Planning",{"name":21,"slug":22,"type":13},"2026-07-27T06:07:16.673218",{"slug":1619,"name":1619,"fn":1620,"description":1621,"org":1622,"tags":1623,"stars":1511,"repoUrl":1512,"updatedAt":1627},"post-build-flow","verify and set up n8n workflows","Handles workflow verification and setup after build-workflow succeeds, or when the message contains workflow-verification-follow-up or workflow-setup-required. Load after direct builds, when verificationReadiness requires action, or on orchestrator verify\u002Fsetup follow-up turns.",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1624,1625,1626],{"name":1521,"slug":1522,"type":13},{"name":8,"slug":8,"type":13},{"name":21,"slug":22,"type":13},"2026-07-24T05:37:08.421329",{"slug":1629,"name":1629,"fn":1630,"description":1631,"org":1632,"tags":1633,"stars":1511,"repoUrl":1512,"updatedAt":1637},"workflow-builder","build and edit n8n workflows","Load before calling build-workflow. Default path for all single-workflow work: new one-off workflows, existing-workflow edits, verification repairs, and workflow-local data tables. Write or edit a workspace source file, then call build-workflow with filePath. When the workflow creates or writes Data Tables, load data-table-manager first, then this skill. Do not load planning or create-tasks first. Load planning only when multiple coordinated workflows or shared cross-task data tables require a dependency-aware task graph.",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1634,1635,1636],{"name":1521,"slug":1522,"type":13},{"name":8,"slug":8,"type":13},{"name":21,"slug":22,"type":13},"2026-07-30T05:30:07.798011",{"slug":1639,"name":1639,"fn":1640,"description":1641,"org":1642,"tags":1643,"stars":23,"repoUrl":24,"updatedAt":1649},"n8n-agents-official","build AI agents in n8n","Use when building or editing any AI feature in n8n: AI Agents, Text Classifier, Information Extractor, Sentiment Analysis, Summarization Chain, Basic LLM Chain, embeddings, vector stores, single one-shot LLM calls, or AI media generation (image \u002F audio \u002F video) via the native LangChain provider nodes. Triggers on any `@n8n\u002Fn8n-nodes-langchain.*` node, \"agent\", \"chat assistant\", \"LLM with tools\", \"tool calling\", \"fromAi\", \"system prompt\", \"memory window\", \"structured output\", \"outputParser\", \"function calling\", \"RAG\", \"vector store\", \"embeddings\", \"classify with AI\", \"extract fields with LLM\", \"sentiment analysis\", \"summarize with LLM\", \"single LLM call\", chat triggers with files, AI image \u002F video \u002F audio generation, or any multi-turn or one-shot LLM behavior.",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1644,1645,1648],{"name":1561,"slug":1562,"type":13},{"name":1646,"slug":1647,"type":13},"LLM","llm",{"name":21,"slug":22,"type":13},"2026-07-08T05:44:47.938896",25,{"items":1652,"total":1735},[1653,1659,1672,1688,1704,1711,1722],{"slug":1639,"name":1639,"fn":1640,"description":1641,"org":1654,"tags":1655,"stars":23,"repoUrl":24,"updatedAt":1649},{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1656,1657,1658],{"name":1561,"slug":1562,"type":13},{"name":1646,"slug":1647,"type":13},{"name":21,"slug":22,"type":13},{"slug":1660,"name":1660,"fn":1661,"description":1662,"org":1663,"tags":1664,"stars":23,"repoUrl":24,"updatedAt":1671},"n8n-binary-and-data-official","handle binary data and files in n8n","Use when handling files, images, attachments, or binary data in n8n, OR when an AI agent needs to take a user-uploaded file as tool input or return a generated file. For Data Tables (schemas, dedup, persistent state), see the separate n8n-data-tables-official skill. Triggers on \"file\", \"image\", \"PDF\", \"attachment\", \"binary\", \"upload\", \"download\", chat trigger with files, agent tool that needs a file, vision\u002Fmultimodal, or any handling of non-JSON file data.",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1665,1666,1669,1670],{"name":1521,"slug":1522,"type":13},{"name":1667,"slug":1668,"type":13},"File Uploads","file-uploads",{"name":8,"slug":8,"type":13},{"name":21,"slug":22,"type":13},"2026-07-08T05:45:01.884342",{"slug":1673,"name":1673,"fn":1674,"description":1675,"org":1676,"tags":1677,"stars":23,"repoUrl":24,"updatedAt":1687},"n8n-code-nodes-official","write custom logic in n8n","Use when the user reaches for a Code node, mentions writing JavaScript or Python in n8n, or any custom logic comes up in workflow design. Triggers on \"Code node\", \"Code\", \"JavaScript\", \"Python\", \"custom logic\", \"transform data\", \"$input\", \"$json transformation\", \"loop in code\", \"write a function\", or any time the obvious answer seems to be \"just put it in code.\"",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1678,1681,1684],{"name":1679,"slug":1680,"type":13},"Engineering","engineering",{"name":1682,"slug":1683,"type":13},"JavaScript","javascript",{"name":1685,"slug":1686,"type":13},"Python","python","2026-07-08T05:44:49.656127",{"slug":1689,"name":1689,"fn":1690,"description":1691,"org":1692,"tags":1693,"stars":23,"repoUrl":24,"updatedAt":1703},"n8n-credentials-and-security-official","manage credentials and security in n8n","Use when handling any auth, API keys, tokens, OAuth, bearer tokens, basic auth, or secret values in n8n workflows. Triggers on \"API key\", \"token\", \"bearer\", \"OAuth\", \"secret\", \"auth\", \"credentials\", \"Authorization header\", \"x-api-key\", or any node configuration that mentions a third-party service.",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1694,1697,1698,1699,1700],{"name":1695,"slug":1696,"type":13},"Authentication","authentication",{"name":1521,"slug":1522,"type":13},{"name":8,"slug":8,"type":13},{"name":1528,"slug":1529,"type":13},{"name":1701,"slug":1702,"type":13},"Security","security","2026-07-08T05:45:07.766252",{"slug":4,"name":4,"fn":5,"description":6,"org":1705,"tags":1706,"stars":23,"repoUrl":24,"updatedAt":25},{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1707,1708,1709,1710],{"name":18,"slug":19,"type":13},{"name":15,"slug":16,"type":13},{"name":8,"slug":8,"type":13},{"name":21,"slug":22,"type":13},{"slug":1712,"name":1712,"fn":1713,"description":1714,"org":1715,"tags":1716,"stars":23,"repoUrl":24,"updatedAt":1721},"n8n-debugging-official","debug and fix n8n workflow errors","Use when an n8n workflow isn't working, errors appear, results don't match what was expected, or the user says \"this isn't working.\" Triggers on errors, unexpected output, \"it's not working\", \"why is this happening\", \"the workflow stopped\", failure investigation, or any debugging context.",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1717,1718,1719,1720],{"name":1521,"slug":1522,"type":13},{"name":1550,"slug":1551,"type":13},{"name":8,"slug":8,"type":13},{"name":21,"slug":22,"type":13},"2026-07-08T05:45:05.897341",{"slug":1723,"name":1723,"fn":1724,"description":1725,"org":1726,"tags":1727,"stars":23,"repoUrl":24,"updatedAt":1734},"n8n-error-handling-official","implement error handling in n8n","Use when building any webhook-triggered workflow, scheduled\u002Fproduction-bound workflow, wiring a per-node error output, or any workflow where silent failure would drop user-visible work. Triggers on \"webhook\", \"respond to webhook\", \"API\", \"production\", \"error\", \"failure\", \"5xx\", \"try\u002Fcatch\", \"error workflow\", \"onError\", \"continueErrorOutput\", \"error branch\", \"node error output\", \"output(1)\", \"main[1]\", \"scheduled\", or any workflow that runs unattended.",{"slug":8,"name":8,"logoUrl":9,"githubOrg":10},[1728,1729,1730,1733],{"name":1550,"slug":1551,"type":13},{"name":8,"slug":8,"type":13},{"name":1731,"slug":1732,"type":13},"Operations","operations",{"name":21,"slug":22,"type":13},"2026-07-08T05:44:59.710099",14]