Vue 3 Migration Guide​

This guide is primarily for users with prior Vue 2 experience who want to learn about the changes between Vue 2 and Vue 3.This is not something you have to read from top to bottom before trying out Vue 3. The recommended way to learn Vue 3 is by reading thenew documentation.

Get the free Migration Guide Cheat Sheet atVueMastery.com

Notable New Features​

Some of the new features to keep an eye on in Vue 3 include:

• Composition API*
• SFC Composition API Syntax Sugar (<script setup>)*
• Teleport
• Fragments
• Emits Component Option**
• createRenderer API from@vue/runtime-core to create custom renderers
• SFC State-driven CSS Variables (v-bind in<style>)*
• SFC<style scoped> can now include global rules or rules that target only slotted content
• Suspense^experimental

_{* Now also supported inVue 2.7
** Supported in Vue 2.7, but only for type inference}

Breaking Changes​

Breaking changes between Vue 2 and Vue 3 are listedhere.

New Framework-level Recommendations​

New framework-level recommendations are listedhere.

Migration Build​

If you have an existing Vue 2 project or library that you intend to upgrade to Vue 3, we provide a build of Vue 3 that offers Vue 2 compatible APIs. Check out theMigration Build page for more details.