Upgrade a Component's API Version

To apply bug fixes and enable new features that are available in a later API version, upgrade your component's API version.

A warning in an API version can become an error in the next API version. We recommend that you test each version and upgrade one version at a time.

To upgrade your component API version:

  1. Publish your component. Fix any warnings in the SFDX console.
  2. Run your component in a sandbox. Fix any warnings in the browser DevTools console.
  3. Increment the apiVersion in the *.js-meta.xml file for your component to the next version.
  4. Publish your component again and verify that you no longer see any warnings.

For example, if you specify an apiVersion value of 58.0, your component continues to behave as it did in API version 58.0 (Summer '23). Your component doesn't include the bug fixes and enhancements that are introduced in version 59.0 and later.

Regardless of apiVersion, custom components always use the latest version of Lightning Data Service and base Lightning components.