Legacy and deprecated components
Learn about legacy and deprecated components.
Retool continually updates UI components for web and mobile apps. In most cases, no user action is required. There is no disruption to your apps and you can benefit from newer functionality whenever it's added.
While Retool makes every effort to develop components in such a way that they can evolve without disruption, there may be instances where it is not possible to update an existing component. There may also be newer functionality that makes an existing component redundant. If this occurs, you need to update existing apps and migrate the older component to the newer version.
Legacy components
A legacy component is one that has been superseded by a newer, separate component, but still available for use. The newer component provides the same general functionality but works differently. Because of this, Retool continues to support legacy components alongside their newer versions so that customers can become familiar with the newer version and start using it. Going forward, only the newer component receives feature updates.
Each legacy component remains available for an indefinite period before being deprecated.
Deprecated components
A deprecated component is one that is no longer supported by Retool. It continues to work in existing apps but should not be used in newer ones.
Deprecated components are hidden by default. Admins can enable the Deprecated components option in the Beta organization settings allow the use of older components, but this is not recommended.
Upgrades and migrations
Whenever you add a component to an app, the app uses the version current at the time. For example, if you built an app in 2022 and open it today, it would use the component versions from that time. Any existing apps with legacy or deprecated components will continue to function.
In general, you must migrate from an existing legacy or deprecated component to use a newer version. This requires updating your apps to use the newer component version. Occasionally, Retool may be able to automatically upgrade a component. If this is possible, the Upgrade component option will be present in the Inspector.