# Apps SDK v1 → v2 Automated Migration Now Available

**URL:** <https://community.canva.dev/t/apps-sdk-v1-v2-automated-migration-now-available/8268>\
**Category:** Announcements\
**Tags:** apps-in-canva\
**Created:** [September 15, 2025, 4:25am UTC](https://community.canva.dev/t/apps-sdk-v1-v2-automated-migration-now-available/8268 "2025-09-15T04:25:49Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Tomos](https://sea1.discourse-cdn.com/canva/user_avatar/community.canva.dev/tomos/32/213_2.png) [@Tomos](https://community.canva.dev/u/Tomos)\
**Post date:** [September 15, 2025, 4:25am UTC](https://community.canva.dev/t/apps-sdk-v1-v2-automated-migration-now-available/8268/1 "2025-09-15T04:25:49Z")

</div>

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:

```json
"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:

```shell
npm install -g @canva/cli@latest

```

Then, from your project root, run:

```shell
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

- [@canva/cli](https://www.npmjs.com/package/@canva/cli)
- [Apps SDK v2 Migration guide](https://www.canva.dev/docs/apps/v2-migration-guide/)
- [Apps SDK v2 Upgrade FAQ](https://www.canva.dev/docs/apps/v2-migration-faq/)
- [Deprecation policy](https://www.canva.dev/docs/apps/deprecation-policy/)