Skip to main content

App Migration Guide

Guide to migrating apps between versions.

Migration Checklist​

  • Backup current app
  • Review breaking changes
  • Update app.json
  • Update hook implementations
  • Test all hooks
  • Verify assets load
  • Test on staging

Common Migration Tasks​

app.json Updates​

Update app metadata:

{
  "id": "app-id",
  "version": "2.0.0",
  "compatibility": {
    "minVersion": "2.0.0"
  }
}

Hook Updates​

Update hook names if changed:

// Check hook documentation for updates
liquid.registerHook('updated_hook_name', handler);