As part of the latest release of the @canva/cli (v1.2.0), you can now automatically upgrade your apps from Apps SDK v1 to v2!
We’ve built a new migration command: canva apps migrate that handles most of the upgrade work for you with minimal manual effort.
Do I need to migrate to v2?
You’ll need to migrate if your app is still using v1.x versions of @canva packages.
Check your package.json, and if you see something like:
"dependencies": {
"@canva/design": "1.x.x",
"@canva/asset": "1.x.x"
}
or any @canva/* package on 1.x.x, then your app is on v1 and must be upgraded.
If your app uses v1 APIs, it will stay in the marketplace after the 25th of September 2025, and we’ll provide a grace period for you to upgrade to v2 APIs using the migration tool. We’ll reach out before taking any action on your app.
How to migrate
First, update to the latest CLI:
npm install -g @canva/cli@latest
Then, from your project root, run:
canva apps migrate apps-sdk-v1-v2
The command will:
- Update your code and dependencies automatically where possible
- Add TODO comments for changes that need manual updates
- Generate a migration summary file so you can review all the changes
After running the migration, review the TODOs, check the summary file, and test your app.
What’s next
Currently, apps-sdk-v1-v2 is the only migration available. But the canva apps migrate command is designed to support more migrations in the future, so you’ll have an easier time keeping your apps current as the platform evolves.
Share your feedback
This is a brand-new migration tool, and we’d love your feedback.
Hit a bug or something doesn’t work quite right? Run canva bug to file an issue directly on GitHub. For general feedback or suggestions, comment in this thread.
Helpful links