Files
n8n-mcp/versioned-nodes.md
czlonkowski e209bf3a81 fix: handle version arrays in node parser for correct version extraction
- Fixed extractVersion to properly handle nodes with version arrays like [1, 1.1, 1.2]
- Updated detectVersioned to mark nodes with version arrays as versioned
- Added test script to verify version extraction
- Gmail Trigger now correctly shows version 1.2 instead of 1
- All 97 nodes with version arrays now show their latest version
- Database rebuilt with correct versions for all affected nodes

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-18 22:38:26 +02:00

6.2 KiB

Versioned Nodes in n8n

This document lists all nodes that have version defined as an array in their description.

From n8n-nodes-base package:

  1. Airtop - Airtop.node.js
  2. Cal Trigger - CalTrigger.node.js
  3. Coda - Coda.node.js
  4. Code - Code.node.js - version: [1, 2]
  5. Compare Datasets - CompareDatasets.node.js
  6. Compression - Compression.node.js
  7. Convert To File - ConvertToFile.node.js
  8. Email Send V2 - EmailSendV2.node.js
  9. Execute Workflow - ExecuteWorkflow.node.js
  10. Execute Workflow Trigger - ExecuteWorkflowTrigger.node.js
  11. Filter V2 - FilterV2.node.js
  12. Form Trigger V2 - FormTriggerV2.node.js
  13. GitHub - Github.node.js
  14. Gmail Trigger - GmailTrigger.node.js
  15. Gmail V2 - GmailV2.node.js
  16. Google Books - GoogleBooks.node.js
  17. Google Calendar - GoogleCalendar.node.js
  18. Google Docs - GoogleDocs.node.js
  19. Google Drive V1 - GoogleDriveV1.node.js
  20. Google Firebase Cloud Firestore - GoogleFirebaseCloudFirestore.node.js
  21. Google Slides - GoogleSlides.node.js
  22. Google Translate - GoogleTranslate.node.js
  23. GraphQL - GraphQL.node.js
  24. HTML - Html.node.js
  25. HTTP Request V3 - HttpRequestV3.node.js - version: [3, 4, 4.1, 4.2]
  26. HubSpot V2 - HubspotV2.node.js
  27. If V2 - IfV2.node.js
  28. Invoice Ninja - InvoiceNinja.node.js
  29. Invoice Ninja Trigger - InvoiceNinjaTrigger.node.js
  30. Item Lists V2 - ItemListsV2.node.js
  31. Jira Trigger - JiraTrigger.node.js
  32. Kafka Trigger - KafkaTrigger.node.js
  33. MailerLite Trigger V2 - MailerLiteTriggerV2.node.js
  34. MailerLite V2 - MailerLiteV2.node.js
  35. Merge V2 - MergeV2.node.js
  36. Microsoft SQL - MicrosoftSql.node.js
  37. Microsoft Teams V1 - MicrosoftTeamsV1.node.js
  38. Mindee - Mindee.node.js
  39. MongoDB - MongoDb.node.js
  40. Move Binary Data - MoveBinaryData.node.js
  41. NocoDB - NocoDB.node.js
  42. OpenAI - OpenAi.node.js
  43. Pipedrive Trigger - PipedriveTrigger.node.js
  44. RabbitMQ - RabbitMQ.node.js
  45. Remove Duplicates V1 - RemoveDuplicatesV1.node.js
  46. Remove Duplicates V2 - RemoveDuplicatesV2.node.js
  47. Respond To Webhook - RespondToWebhook.node.js
  48. RSS Feed Read - RssFeedRead.node.js
  49. Schedule Trigger - ScheduleTrigger.node.js
  50. Set V1 - SetV1.node.js
  51. Set V2 - SetV2.node.js
  52. Slack V2 - SlackV2.node.js
  53. Strava - Strava.node.js
  54. Summarize - Summarize.node.js
  55. Switch V1 - SwitchV1.node.js
  56. Switch V2 - SwitchV2.node.js
  57. Switch V3 - SwitchV3.node.js
  58. Telegram - Telegram.node.js
  59. Telegram Trigger - TelegramTrigger.node.js
  60. The Hive Trigger - TheHiveTrigger.node.js
  61. Todoist V2 - TodoistV2.node.js
  62. Twilio Trigger - TwilioTrigger.node.js
  63. Typeform Trigger - TypeformTrigger.node.js
  64. Wait - Wait.node.js
  65. Webhook - Webhook.node.js - version: [1, 1.1, 2]

From @n8n/n8n-nodes-langchain package:

  1. Agent V1 - AgentV1.node.js
  2. Chain LLM - ChainLlm.node.js
  3. Chain Retrieval QA - ChainRetrievalQa.node.js
  4. Chain Summarization V2 - ChainSummarizationV2.node.js
  5. Chat Trigger - ChatTrigger.node.js
  6. Document Default Data Loader - DocumentDefaultDataLoader.node.js
  7. Document GitHub Loader - DocumentGithubLoader.node.js
  8. Embeddings OpenAI - EmbeddingsOpenAi.node.js
  9. Information Extractor - InformationExtractor.node.js
  10. LM Chat Anthropic - LmChatAnthropic.node.js
  11. LM Chat DeepSeek - LmChatDeepSeek.node.js
  12. LM Chat OpenAI - LmChatOpenAi.node.js
  13. LM Chat OpenRouter - LmChatOpenRouter.node.js
  14. LM Chat xAI Grok - LmChatXAiGrok.node.js
  15. Manual Chat Trigger - ManualChatTrigger.node.js
  16. MCP Trigger - McpTrigger.node.js
  17. Memory Buffer Window - MemoryBufferWindow.node.js
  18. Memory Manager - MemoryManager.node.js
  19. Memory MongoDB Chat - MemoryMongoDbChat.node.js
  20. Memory Motorhead - MemoryMotorhead.node.js
  21. Memory Postgres Chat - MemoryPostgresChat.node.js
  22. Memory Redis Chat - MemoryRedisChat.node.js
  23. Memory Xata - MemoryXata.node.js
  24. Memory Zep - MemoryZep.node.js
  25. OpenAI Assistant - OpenAiAssistant.node.js
  26. Output Parser Structured - OutputParserStructured.node.js
  27. Retriever Workflow - RetrieverWorkflow.node.js
  28. Sentiment Analysis - SentimentAnalysis.node.js
  29. Text Classifier - TextClassifier.node.js
  30. Tool Code - ToolCode.node.js
  31. Tool HTTP Request - ToolHttpRequest.node.js
  32. Tool Vector Store - ToolVectorStore.node.js

Examples of Version Arrays Found

Here are some specific examples of version arrays from actual nodes:

n8n-nodes-base:

  • Code: version: [1, 2]
  • HTTP Request V3: version: [3, 4, 4.1, 4.2]
  • Webhook: version: [1, 1.1, 2]
  • Wait: version: [1, 1.1]
  • Schedule Trigger: version: [1, 1.1, 1.2]
  • Switch V3: version: [3, 3.1, 3.2]
  • Set V2: version: [3, 3.1, 3.2, 3.3, 3.4]

@n8n/n8n-nodes-langchain:

  • LM Chat OpenAI: version: [1, 1.1, 1.2]
  • Chain LLM: version: [1, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.7]
  • Tool HTTP Request: version: [1, 1.1]

Summary

Total nodes with version arrays: 97 nodes

  • From n8n-nodes-base: 65 nodes
  • From @n8n/n8n-nodes-langchain: 32 nodes

These nodes use versioning to maintain backward compatibility while introducing new features or changes to their interface. The version array pattern allows n8n to:

  1. Support multiple versions of the same node
  2. Maintain backward compatibility with existing workflows
  3. Introduce breaking changes in newer versions while keeping old versions functional
  4. Use defaultVersion to specify which version new instances should use

Common version patterns observed:

  • Simple incremental: [1, 2], [1, 2, 3]
  • Minor versions: [1, 1.1, 1.2] (common for bug fixes)
  • Patch versions: [3, 4, 4.1, 4.2] (detailed version tracking)
  • Extended versions: [1, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.7] (Chain LLM has the most versions)