Base Components Minimum API Version

Base components are not currently versioned. Changing your custom component’s API version in the .js-meta.xml configuration file to an earlier version does not impact the behavior of a base component you're using. So if you're using a base component in a custom component that's set to API version 60.0, its behavior does not change if you set your component to 59.0 or 61.0. The latest behavior is observed across all versions.

However, changing your component's API version tells the framework to behave as it did for that particular release.

Consider these guidelines when working with base components.

  • When you use a base component in a custom component, you can specify an API version 45.0 and later for your custom component in the .js-meta.xml file. This API version you specify is the version of the framework that your custom component uses.
  • As of Winter '24, custom components with API versions of 58.0 and earlier correspond to 58.0 (Summer '23). If you set the API version to a value lower than 58.0, LWC uses version 58.0 by default.

We recommend that you update the API version of your components to take advantage of the latest features and bug fixes.

See Also