How to upgrade

Let's say you are upgrading an app from v3.4 to v3.8. Although you heard there are some new features, your main goal is to keep up with security updates. To do this kind of version upgrade, follow the instructions here in the CLI Guides. That process will make sure that any peer dependencies of the ember.js core codebase get upgraded too. Automated tools will help you make the right changes to package.json and other files. The point of a minor version bump is that you shouldn't need to change anything in your app when you upgrade - it should all keep working, whether or not you choose to adopt new syntaxes and features.

Once you have upgraded an app's version, some new features may be available out of the box. On the other hand, some features will require that you enable them specifically in your app's configuration, since they may change the app's default behavior.

The best way to discover new features is to read the release blog posts. If a new feature requires you to opt-in, it's called an optional feature. Follow the optional features guide to learn which optional features are available in your app's version of Ember, and how to enable them. In many cases, codemods will be available to help you make syntax-related updates. A codemod is a tool that rewrites your existing code into a new syntax. When they are available, they can save a lot of time that you would spend making edits by hand.

If an API you are using will be going away in the next major version of Ember, you will see a deprecation warning in the developer console. Sometimes, they will be deprecation warnings caused by code in your app, and other times, they may be caused by an addon.

For more guidance on what to do with deprecations, visit Handling Deprecations, check out the Ember Inspector tools for deprecations, or read about the specifics in the Deprecations Guides.

Octane was a big shift in Ember's syntax, features, and mental models! If you are in the process of upgrading an existing app to use Octane patterns, check out our dedicated Octane Update Guide.