n8n Version Trigger icon

n8n Version Trigger

Triggers workflow based on n8n version status using cron schedule

n8n Version Trigger

AI-generated

Summary

Schedule cron-based checks to monitor if the installed n8n version is up-to-date or updated, optionally fetching release notes, and trigger a workflow based on version availability and update relevance.

Inputs

  • Trigger On (required) — Choose between preset intervals (every minute, hour, day, week) or a custom cron expression to specify when version checks occur.
  • Interval (required) — Select how often to check for updates using standard intervals (only shown if 'Trigger On' is 'Interval').
  • Cron Expression (required) — Provide a custom cron expression to schedule checks (only shown if 'Trigger On' is 'Custom Cron Expression').
  • Trigger Condition (required) — Set whether the workflow triggers only when a new version is available or on every check regardless of the version status.
  • SemVer Level (required) — Define the minimum semantic version level for triggering on updates: major, minor, or patch (only applicable if 'Trigger Condition' is 'Update Available').
  • Ignore Prereleases (required) — Choose to ignore prerelease versions (alpha, beta, rc, etc.) when checking for updates.
  • Fetch Changelog (required) — Enable to fetch release notes from GitHub when triggering the workflow.
  • Changelog Version (required) — Select which version's changelog to fetch: the latest version or the currently installed version (shown only if 'Fetch Changelog' is enabled).
  • Strip Links (required) — Strip markdown links from the fetched changelog text (shown only if 'Fetch Changelog' is enabled).

Output shape

A single output containing a JSON object per trigger event.

Each JSON object includes current version, latest version, isLatest flag, update type, error if any, timestamp triggeredAt, trigger condition, and if fetching changelog, the changelog text, changelog version, and any changelog fetch errors. The node emits only when the trigger condition is met based on configuration.

Examples

Example 1: Check every hour for any new n8n release (patch or higher) and trigger only if an update is available.

Set 'Trigger On' to Interval, 'Interval' to Every Hour, 'Trigger Condition' to Update Available, 'SemVer Level' to Patch, 'Ignore Prereleases' enabled, and 'Fetch Changelog' disabled.

Example 2: Run workflow every day unconditionally with full release notes of the latest version.

Set 'Trigger On' to Interval, 'Interval' to Every Day, 'Trigger Condition' to Always, 'Fetch Changelog' enabled, 'Changelog Version' to Latest Version, optionally enabling 'Strip Links'.

Links

Discussion