Changelog

Multipage apps are now generally available. Any new Retool apps that you create will support multiple pages by default. The creation of single-page apps is still supported but they are now considered legacy. Multipage for mobile apps remains in beta.

Building apps with multiple pages enables you to combine functionality and use cases. Retool only evaluates the code and components of the page currently in view, providing the following benefits:

• Greater performance of large and complex apps. Since Retool only evaluates code and components for the current page, apps can perform 30-40% faster.
• Seamless navigation between pages. Navigation between pages is seamless and more responsive than before as Retool only evaluates the current page, not the entire app.
• Improved app management. Multiple pages can replace multiple apps in your organization, such as a team's frequently used apps. This reduces the number of apps to maintain and allows for easier permission management.
• Reduced module dependency. Modules are commonly used to create shared navigation menus across multiple apps. With multiple pages, you can eliminate the need for additional modules and the complexities with maintaining them.

Each app uses global and page scopes to separate pages. Globally scoped code, and Header and Sidebar frames, are available for use across every page, while each page has its own page-scoped code and components.

You can now test deployments when using Source Control, preventing changes that leave your Retool instance in a broken state. Retool added the Test source control changes endpoint to the Retool API, which enables you to test whether implementing a change will result in deployment issues.

You can also incorporate this check into your continuous integration process if desired.

Improvements to the Navigation component are now available. When you add a Navigation component to an app with multiple pages, Retool automatically configures the menu items to map to the pages of your app. Event handlers are also preconfigured, and clicking a menu item takes you to the corresponding page.

You can still customize the Navigation component to have different behavior, if desired. Refer to the Navigation guide for more information.

This change also made retoolContext.pages and retoolContext.currentPage available. Refer to the Retool Context reference for more information.

This change is currently available on Retool Cloud, and it will be available on Self-hosted Retool 3.123-edge.

Self-hosted Retool 3.114 is now available on the Stable release channel.

Retool has deprecated version 1.0 of the MySQL connector. If your organization has any MySQL resources that still use this connector version, update their configuration to use the version 2.0 connector.

The option to use version 1.0 of the MySQL connector will be removed in Q2 2025 from Retool Cloud and subsequent releases of self-hosted Retool.