Changelog

App Documentation

**READMEs. **README files are a staple of any programming project. If you're on the Startup plan or above, all of your Retool apps now come equipped with a built-in README file. To open it, click on the app’s description in the navigation bar. The Editor README is a great place for sharing information with other Retool editors in your organization: details on working with data sources, descriptions of business logic, or ground rules for making changes.

User Documentation. Of course, developers aren’t the only ones who benefit from documentation. For customers on plans that support end-user only permissions (Pro and above), we’ve also added User Documentation support. Here you can provide information that will be visible to your app’s users, like how to operate the app and who to contact when there’s an issue. (You can also set the docs to open automatically for users firing up the app for the first time.)

To learn more about App Documentation and how to bring sophisticated text display to Retool, check out our blog.

Fixes and improvements​

• Introduced ⌘/⌃X to cut/paste components on the canvas and between apps
• Corrected placement of pasted components to be more predictable
• Improved the Text component:
  • Reintroduced a background color option
  • Reintroduced support for the class attribute on HTML elements
  • Improved styles for nested lists and headlines
  • Fixed a bug where toggling staging mode would reset the height
• Added the ability to turn a Container into a Tabbed Container from the component’s Inspector menu
• Updated the Container deletion confirmation to list child components that will also be deleted
• Updated Table and Chart to use the currently selected query by default when created
• Updated the Table setFilters_ _API to support "OR" in addition to "AND"
• Fixed a bug where custom CSS did not load correctly in Modules
• Added support for tabbing between components in the editor
• Added support for opening a new tab from the Omnibox by holding ⌘/⌃
• Added keyboard shortcut to toggle the canvas grid lines (⌘/⌃+Shift+G)
• Updated the Query Library to display duration after running a query
• Updated the Releases list to include the creator and publisher of each release
• Fixed a bug where renamed components, queries, and transformers could collide with reserved Retool names (e.g. utils)
• Fixed a rare bug where JS references to a component wouldn't be updated on rename
• Improved error messages when renaming components, queries, and transformers
• Redesigned tooltips in the Inspector
• Updated the Alert component to be resizable up to 4 rows in height
• Fixed a bug where editors without "use" permissions could add a Module to apps
• Fixed Snowflake queries to respect the_ DBCONNECTOR_QUERY_TIMEOUT_MS_ env variable
• Fixed a bug with Stripe queries that contain array parameters
• Fixed a bug in Google Cloud Storage queries where the default export file type was invalid
• Fixed a bug where disabled users would show up in the app users list

Enterprise Plan​

• Updated protected apps to create an initial commit when starting with an empty repo
• Fixed author data when syncing protected branches to Retool
• Fixed a rare bug where the GitHub API would not return the entire tree for a protected app's repo

Text v2​

We’ve just launched a brand new version of our Text component. The component includes:

• Full support for all GitHub flavored markdown features — 6 different headline sizes, bold, italics, strikethrough, underline, bullet lists, numbered lists, task lists, images, links, blockquotes, code blocks, and tables.
• Dynamic height with the “hug contents” option, on by default
• Inspector improvements including a markdown-aware code editor and image scaling options

The new Text component no longer supports advanced HTML rendering. If you require more custom HTML, check out the iFrame component or the Custom component.

App specific styles and scripts​

You might have noticed that the Text component doesn’t support adding style tags for custom CSS. Good news is, you no longer have to hack in CSS into random Text components. You can now add styles specific to your application in the “Scripts and styles” modal. As the name suggests, this panel also lets you add JS libraries and define custom code in your applications.

Layout improvements and dynamic containers

We’ve refreshed the way drag and drop works in the editor for easier editing and a faster feedback loop:

• Redesigned component bounding box for easier selection, drag, and resize
• Instant drag-and-drop feedback with no countdown timer
• Major improvements and fixes to layout reflows from drag-and-drop and hidden components
• Hidden components are now visible when selected
• Support for opening/closing modals and switching Tabbed container tabs during drag-and-drop

We’ve also added dynamically resizing to some containers. The Container component, Tabbed Container component, and Form components now include a “hug contents” setting that automatically sets the height of the container based on the height of its contents!

For a quick guide on how these changes can make you faster at editing, check out the docs.

Chart v2​

Our new chart component, built on top of the open source Plotly library, makes data visualizations easier to build, update, and consume. It makes it simple to build charts right out of the box with all of the basics—like mixed chart types, built-in aggregations, and support for grouping—included. And because you’re building charts in Retool, you can take action on the data you’re looking at by easily writing back to your database, making an API request, or whatever else is impactful. See how other Retool users are leveraging charts in our blog post or checkout our webinar on how to build data-driven dashboards in Retool.

Modules​

Modules are a new way for Retool customers to reuse groups of components and queries between applications. Modules give you the ability to create a shared library of reusable components and queries that you can use in any Retool application. Any update you make to a module is immediately reflected in every app it powers. Check out our blog post and the docs.

User Management Improvements​

A brand new UI and folder-based permissions. Quickly and effortlessly manage access for many users.

A suite of new integrations

We’ve added integrations for Jira, Asana, Datadog and BigID, with many more to come!

Refreshed Query UIs​

We’ve updated our UI for some of our most popular integrations including Stripe, Twilio and Sendgrid. Among many visual improvements, the new UI includes inline documentation for the resources so you no longer have to constantly switch between Retool and the Stripe/Twilio/Sendgrid documentation when writing your queries.

New

• Added support for attachments in the SMTP integration
• Added support for renaming resources without breaking references to the resource in apps
• Added misc. improvements to the UX of modules

Protected applications (beta)

• Fixed switching between branches in protected apps that were placed in a folder.
• Showed better error messages when invalid branch names are chosen

Bugfixes

• Improved error message when queries fail due to network errors
• Removed requirement to manually enable custom analytics on each app

New

• Added a new SMTP Integration which supports sending emails to arbitrary SMTP servers.
• **2FA **is now a feature all paid plans have available.
• Added support for server variables in the **OpenAPI **integration
• Added option to configure the min and max database pool size that on-prem Retool uses

Protected Applications (Beta)

• Added support for using Protected Applications at the same time with the existing git syncing workflow.
• Various UX improvements

Modules (Beta)

• Added option to add descriptions to modules
• Added option to convert existing containers into modules

Performance improvements

• Users of a local Retool deployment can add the environment variable APPS_FS_SYNC_WATCHER=true to greatly improve the performance of modifying Retool apps.
• Reduced the main bundle size of the Retool app by ~30%.
• Added a cache for utilities used in the runtime of Retool.

Bugfixes

• Fixed issue in the **Table **component where date type columns did not support selecting a time of day.

• Fixed issue where the **SAP Hana **integration would not work when connecting to the database via a SSH tunnel

• Fixed issue where **Textinputs **would not accept negative number or currency values

• Fixed issue where components could not be copy-pasted immediately after using CMD+C

• Fixed issue where the Dropdown component sometimes may render its values behind another component

• Fixed issue with Tabbed Containers when the list of tab names contains objects

New

• Added support for Docker secrets in Retool's on-prem deployment

• Added support for parsing group claims in the **Custom OAuth2 SSO integration. **

• Added support for Google SSO in the **Custom OAuth2 SSO integration. **

• Official Helm 3 chart for Retool available. Helm 2 charts are available here.

• Added tools to debug the authentication flow for resources configured using **Custom Auth **

• Redesigned the database schema browser

• Changed REST API resources to allow for empty base URLs

Performance improvements

• Transition speed between different apps greatly improved
• Cleaned up some unnecessary libraries and code

Bugfixes

• Fixed issue where single-container on-prem deployments no longer supported SSH connections

• Fixed issue where text would overflow in Button components when the label was too long

• Fixed issue where the SAP Hana integration would unexpectedly hang

• Fixed visual issue with Table headers when using themes

• Fixed issue where the ReorderableList would not work with duplicate values

• Fixed visual bugs of the Settings page on wider screens

• Fixed custom dimensions support in our Google Analytics integration

• Fixed visual bug when inviting additional users

• Fixed issue where the staging / production toggle would still appear even when you had set the HIDE_PROD_AND_STAGING_TOGGLES environment variable to true