Skip to main content

Version requirement (LauncherVersion)

LauncherVersion declares the minimum launcher version a widget requires. It is useful for widgets that depend on newer plugin APIs, Data types or actions.

Syntax

Supported:
  • 1
  • 1.4
  • 1.4.0
  • 1.4.0-beta.1

Runtime behavior

  • Launcher version ≥ required version: renders normally.
  • Launcher version < required version: shows an error placeholder “Requires launcher X or later (current Y)” and does not run the widget content.
  • Launcher version unavailable (for example in the browser debug environment): no version gate.
  • Nested widgets check their own LauncherVersion independently.

Editor

The information panel shows:
It is highlighted in red when the current version is below the requirement.

Difference from other version fields

Recommendations

  • You can omit it when you only use APIs already available in the current stable release.
  • Set a minimum version when using new actions, new Data types or new Host APIs.
  • Raise LauncherVersion together when a widget update starts requiring more.