Migration
How to move an existing Grav 1.7 or 1.8 site to Grav 2.0. Covers the recommended Migrate to Grav 2.0 plugin, a manual procedure for complex setups, AI-assisted development for porting custom plugins, and troubleshooting.
Overview
Migrating to Grav 2.0 Grav 2.0 is a major version change. The vendor stack (Symfony, Twig, Monolog, and friends) jumps a generation, the minimum PHP version moves to 8.3, and the classic admin is replaced by Admin 2.0 running against the new Grav API plugin. Because of all that, Grav 2.0 is n...
Assisted Migration to Grav 2.0
Assisted Migration to Grav 2.0 The Migrate to Grav 2.0 plugin is the recommended way to move from Grav 1.7 or 1.8 to Grav 2.0. It installs on your existing 1.x site, downloads a fresh Grav 2.0 build, and hands off to a standalone browser-based wizard that performs the rest of the migration in a...
Manual Migration to Grav 2.0
Manual Migration to Grav 2.0 For most sites, the Migrate to Grav 2.0 plugin is the right tool. It automates every step of the process and runs in a clean PHP environment outside of Grav 1.x. There are setups where the wizard's assumptions do not fit: Multisite installs with shared user fo...
AI-Assisted Development
AI-Assisted Development Porting a plugin or theme from Grav 1.7 to Grav 2.0 is mostly mechanical work: declare a compatibility flag, expose your functionality as API endpoints if you have admin features, port your blueprints and language files to work with Admin 2.0, and adjust to Symfony, Twig, a...
Developer Upgrade Guide
Grav 2.0 Developer Upgrade Guide This page is a developer-focused reference for what has changed under the hood between Grav 1.7 and Grav 2.0. If you maintain a plugin, theme, or custom integration, this is the page that tells you what you need to update. For the end-user migration process itsel...
Troubleshooting
Migration Troubleshooting Common issues encountered during a Grav 1.x → 2.0 migration, with the fixes. "PHP version too low" The wizard refuses to proceed if it cannot find PHP 8.3 or newer. Grav 2.0 requires PHP 8.3 minimum. If your host only offers older versions, you cannot migrate yet. M...
Migrating to Grav
How to migrate to Grav from other content management systems. Covers Drupal 7 and WordPress.