Introduction

This guide helps plugin authors migrate their Sylius extensions from version 1.x to 2.0. It provides a structured workflow — from initial analysis, through code migration, to final verification and release.

What this guide covers

• Step 1: Plugin Analysis & Verification – how to review your plugin, understand dependencies, and define a verification strategy.

• Step 2: TestApplication Setup – preparing a Sylius 2.0 environment for testing and development.

• Step 3: Core Migration Steps – updating code, templates, configuration, API, and assets.

• Step 4: Verification & Testing – validating that critical functionality still works after migration.

Who should read this

• Plugin maintainers migrating their projects from Sylius 1.x to 2.0.

• Developers creating new plugins targeting Sylius 2.0.

• Reviewers and contributors assisting with migration pull requests.

---

🚀 Goal: ensure a smooth, reliable migration process with a focus on core functionality first, polish and secondary features later.