Guide

Plugin Migrations

Plugin state is private Shell data: missing plugin state is preserved, not deleted.

Private State

Plugin state lives inside the encrypted .postsnail Shell and must never enter the public Website ZIP.

Missing Plugins

If a Shell contains state for a plugin that is not installed, PostSnail returns a warning and preserves the state untouched.

Unknown Fields

Unknown plugin fields and future schema data are preserved without interpretation whenever possible.

Future Migrations

Future official plugins can add deterministic migrations through declared hooks and PSEP-reviewed compatibility rules.