Versioning & Migration

Use this section to navigate between major tsParticles versions, track releases, and understand versioning.

Migration guides

Quick route

Coming from v3.x: start with /migrations/from-v3 (focus: option key changes + package renames).
Coming from v2.x: start with /migrations/from-v2 (focus: load(...) API + options).
Coming from v1.x: start with /migrations/from-v1 (focus: packages, loaders, options audit).

Where migrations usually break

Most major migrations break in two places:

Load API shape (old positional params vs new object params).
Options schema (renamed/moved keys).

If your app compiles but renders wrong visuals, start from option mappings first.

Fast lookup

Option Rename Matrix — quick mapping of legacy vs current option keys.

Also useful

Changelog — latest release notes.
Releases & Versioning — version alignment rules and release checklist.
particles.js Migration — migrating from legacy particles.js or canvas-confetti.