Changelog

Statistic​

We overhauled our Statistic component! Previously, you could only set a single primary value, and we supported limited formatting options. Now, you can also set a secondary value to compare metrics over different time periods (e.g., to show monthly revenue growth). Additionally, the primary and secondary values have the same powerful customization options as our Number Input component, including currency and percent formatting, decimal place control, and more. The new Statistic component supports more features, including the ability to dynamically control positive and negative trend color, set a caption text, control alignment, and more.

Like all of our new components, the Statistic component also has expanded style editor support. You can automatically migrate your old Statistic components to this new version, too! As always, post in our community forum if you have feedback on this new component or feature requests.

Icon library​

We now offer over 3,000 searchable icons with support for bold and outline styles. You’ll have access to this library anywhere where you can set an icon in Retool. To use any of our old icons, choose the deprecated icon set. These are rolling out to editors over the next week.

Fixes and improvements​

• Added documentation for the majority of component properties, visible in autocomplete and model browser tooltips
• Improved app performance on page load
• Fixed Google Datastore ordering options
• Fixed public apps in Incognito mode for Chrome
• Improved SQL auto-formatting
• Fixed "body query type" for REST APIs with custom auth
• Fixed the layout for Image components in Firefox
• Added support for upgrading caret type Toggle components to the new Toggle Link component
• Fixed unexpected layout shifts in apps with tall dynamic height Text components
• Fixed SQL schema column types to display as timestamp or timestamptz instead of timezone
• Added support for an optional label on the File Dropzone component
• Added an option to configure text size on the Divider component

Check out this guide to see the on-prem versions and their release notes. These fixes and improvements will be rolling out to on-prem customers in the next few weeks.

Create and edit resources from your app​

You can now view, edit, and create new resources without leaving your Retool app!

To create a new resource, select the “create a new resource” option from the top of the resource dropdown in any query. You can configure a connection and immediately query any of our 40+ supported database and API types, including Postgres, MongoDB, and any REST API or GraphQL.

To view or edit a resource configuration, click the “edit resource” button from the selected resource in your query. For example, you can view the name of the default bucket of an S3 resource, add staging credentials to a Postgres database, or add a new header to your GraphQL resource—all without leaving your app! Any changes to the resource persist across all Retool apps in your current environment.

We’re rolling out this new functionality this week. Share any feedback or suggestions for new resource types in our community forum!

Fixes and improvements​

• Fixed label wrapping for Checkbox Group, Radio Group, and Switch Group components
• Fixed duplicate or null values in Select, Multiselect, Listbox, and Multiselect Listbox components
• Fixed the "Go to app" event handler in public apps
• Fixed property defaults when switching from one component type to another
• Fixed default value rendering for Select components in edit mode
• Fixed the Table component’s setSort so that it now updates both the sortedColumn and sortedDesc properties

Check out this guide to see the on-prem versions and their release notes. These fixes and improvements will be rolling out to on-prem customers in the next few weeks.

Upgrading components​

Over the past few months, we’ve launched new versions of 20+ components, including Text Input, Button, Toggle/Switch, Progress Bar, and more. These new components have been redesigned and rebuilt from the ground up with more customization options, expanded style editor support, improved keyboard accessibility, and robust validation for inputs.

In order to make it easy for you to use these new components in your existing apps, we’ve built two ways to migrate existing components to these powerful new versions with a few clicks.

Upgrade individual components​

If a selected component has a new version you will see a “Deprecated component” notice at the top of the Inspector. Click “Upgrade” and Retool will automatically upgrade the component to the new version. All of your configuration settings (e.g. event handlers, tooltip content, suffix text, etc) will transfer to the new version. As always, you use ⌘+Z to undo your changes.

Upgrade all components in an app​

We also added a quick way for you to migrate multiple components in an app at once. Click on the app actions menu (three dots in the upper right), then click “Upgrade components”, then select which components to upgrade.

This new upgrade functionality supports common components and is rolling out to customers over the next week. We’re adding support for new components—like Select and Multiselect—to work with these upgrade paths shortly. Post in our community forum to let us know how it’s working and if you have any additional functionality you’d like to see!

Fixes and improvements

• Fixed the recordUpdates and changeSet attributes of the Table component to only clear when a bulk update is successful
• Added a new Pagination component for easily navigating paged data
• Fixed default text color when the canvas has a dark background
• Added support for sharing Jira resource credentials between users
• Added an option to configure text size in Editable Text and Editable Number components
• Fixed the Calendar component so that custom event properties are not lost when events are modified
• Added the ability to customize the appearance of the Retool user menu on a per-app basis (Enterprise only)

Check out this guide to see the on-prem versions and their release notes. These fixes and improvements will be rolling out to on-prem customers in the next few weeks.

Select and Multiselect​

We’ve overhauled two of our most popular components: Select and Multiselect. Like our new Input components, they have powerful new functionality including:

• Expanded style editor support
• Control over label position, alignment, and wrapping
• More robust validation (e.g. min/max items for Multiselect)
• Support for adding text and icons in the prefix and suffix
• An optional tooltip with GitHub flavored markdown

Both components support full keyboard accessibility. For example, you can now use arrow keys to move between individual selected items. These components also have tons of new configuration options including:

• Overlay height: set the maximum height of the dropdown
• Combobox mode: set whether or not the component has an input field to support searching by text
• Selection indicator: control whether the dropdown should show a checkmark on the selected item(s)
• Empty state: set a message to display when the component has no options provided or when no options match the search term
• Disabled: provide an array of values that should be rendered disabled or disable the entire component

New components you’d like to see us add? Let us know in our community forum!

Fixes and improvements​

• Fixed label alignment on the Progress Bar component
• Fixed component styles in ListViews
• Added tooltip support to more components (Avatar, Avatar Group, Divider, IFrame, Image, Progress Bar/Circle)
• Improved CSV parsing capabilities of the File Input components
• Added a warning when trying to preview an app with an unsaved query
• Updated Slider and Range Slider components to support editing the track color
• Fixed the Table component “Row select” and “Row select changed” events to support arrow key selections
• Added support for evaluating an app's UUID dynamically (e.g. {{ retoolContext.appUuid }})
• Added support for reply-to email in SMTP resource
• Fixed the JIRA resource so that it automatically refreshes its token

Check out this guide to see the on-prem versions and their release notes. These fixes and improvements will be rolling out to on-prem customers in the next few weeks.

Scrollable tables​

The Table component is now scrollable! Scrollable tables are a great way to allow your users to quickly explore data.

To try it out, select the new “Scroll” option in the Table component inspector. "Scroll" supports all of the Table component’s “Pagination” options (e.g. server-side pagination) out of the box. To learn more about working with Tables in Retool, check out our documentation.

We’ll be shipping other highly requested Table features and bug fixes in the coming months. Visit our community forum to make a new request or add your support for existing ones.

Fixes and improvements​

• Improved ordering of code autocomplete suggestions
• Added multiline text support for Button components
• Fixed folder creation—now we route you to the newly created folder
• Improved validation to skip any components set to disabled, read only, or hidden
• Updated the PDF Viewer component to support scaling each page to the height of the component, and added an additional option to snap scroll to each page
• Improved fuzzy search performance for the Listbox and Multiselect Listbox components when using the “search term” option
• Updated the Preview button to prevent accidental clicks
• Fixed a rendering bug with the Looker component
• Fixed tree construction so that merge conflicts are properly detected in protected apps (Enterprise plan only)

Check out this guide to see the on-prem versions and their release notes. These fixes and improvements will be rolling out to on-prem customers in the next few weeks.

Avatar and Avatar Group​

****

The new Avatar and Avatar Group components allow you to easily represent users in your app.

Avatar allows you to display an image with an optional label and caption. The image URL will default to the current user’s profile photo (a new property, {{ current_user.profilePhotoUrl }}) and you can optionally set fallback text for when there isn’t a url available — if that text looks like a user's full name, we’ll render just their initials. Choose from a selection of avatar size options, extra small (16px) to extra large (48px), and customize label, alignment, and more!

Avatar Group displays several avatars together. Configure the maximum number of avatars to display, and the last avatar will display “+N” when there are more. Like our new input components, these also offer expanded style editor support.

More components you’d like to see us build? Let us know in our community forum!

Fixes and improvements​

• Added a new option, "show top bar," to IFrame which allows you to optionally show a customizable title, and adds two actions: refresh and open in a new tab
• Fixed Listbox and Multiselect Listbox rendering with duplicate values
• Added autofill for app names when importing an app
• Improved the component search experience by autofocusing the search field when opening the Insert pane
• Improved the loading state for the Table component
• Fixed an edge case where renaming a component didn't rename references to the component
• Added workspaces, audit logs, and data editor to the "powered by Retool" menu
• Updated AWS assume role help text to display the correct backend name
• Added the POSTGRES_STATEMENT_TIMEOUT environment variable, which defaults to 10 seconds (on-prem only)

Check out this guide to see the on-prem versions and their release notes. These fixes and improvements will be rolling out to on-prem customers in the next few weeks.

Editable Text and Number​

We’ve overhauled Editable Text and added a new Editable Number. Like all of our new inputs, these offer brand new configuration options, built-in and custom validation rules, and expanded style editor support. These components were also built with accessibility and data density in mind.

The Editable inputs display static text that can be edited on click. In edit mode, Editable Text has all the same powerful, new functionality of our Text Input component, including: configurable prefix/suffix text, a prefix/suffix icon, read only mode, and more. In addition, Editable Number supports the functionality of the Number Input component, including currency support, percentage formatting, and control over decimal places and padding zeros.

Helper text

All keyboard inputs–like Text Input, Number Input, Editable Text and Number, Currency, and more–can now optionally configure a tooltip that is visible below the input only on focus:

Like the regular tooltip, helper text supports GitHub flavored markdown.

We’re continuing to ship new components each week! Drop us a note at support@retool.com if you have any feedback. Editable Text and Number are rolled out to all plans on Retool cloud, and will be included in the next on-premise release.

Fixes and improvements

• Fixed an edge case where Text components could be rendered at the wrong height
• Added support for freezing action button columns to the left or right of the Table component
• Added the ability to add the currently viewed folder to your favorites list
• Fixed focus, hover, and disabled styles for the clear button on input components
• Added support for null values for sliders in the JSON Schema Form component
• Fixed rendering of short Listbox components with labels
• Added lastReceivedFromResourceAt attribute to queries to track when the query response was last received from the resource
• Added the current page index and total number of rows to the footer of the Table component
• Fixed label width default to be 40% instead of 33%

Check out this guide to see the on-prem versions and their release notes. These fixes and improvements will be rolling out to on-prem customers in the next few weeks.

Input improvements​

We've added 5 new and improved options for input components in the Inspector (right-hand panel), including:

• Read only: read only inputs are focusable and selectable but cannot be modified. They look the same as normal inputs.
• Label width: set the width of the label as a percentage of the component width (%), pixels (px), or grid columns (col).
• **Decimal places: **set the maximum number of digits after the decimal, and optionally pad trailing zeros.
• **Allow null value: **Number Input components can now have an empty state of null instead of 0.
• **Show clear button: **Number Input components can now optionally show a clear button.

If you want further configuration options for any of our components, drop us a note at support@retool.com!

Fixes and improvements​

• Added a keyboard shortcut–⌘ + D (CTRL + D)–to duplicate a component on the canvas
• Added a keyboard shortcut–?–to show a list of all of the other built-in editor shortcuts (like ⌘ + D!)
• Added a "Hide submit button" option to the JSON Schema Form component
• Fixed vertical alignment of multiline labels on the Checkbox and Switch components
• Added a "Row Select Change" event handler for the Table component
• Adjusted default hover and active colors for Button
• Fixed automatic text color for components inside of the Header frame
• Updated read only input components to hide the optional clear button
• Simplified the empty state for Container components
• Fixed a delay with updates to dynamic height components
• Removed an incorrect error message when selecting components in the same container
• Fixed migrations to respect DATABASE_URL (on-prem only)

Check out this guide to see the on-prem versions and their release notes. These fixes and improvements will be rolling out to on-prem customers in the next few weeks.

Retool for Startups​

Eligible startups now get 12 months of free Retool credits (up to $1200 value), and we've partnered with companies like HubSpot, Segment, DigitalOcean, and Brex to offer many more startup discounts (apply here!).

If you applied and were accepted into the Retool for Startups program, you now have access to a new Startup Offers section in your Settings. To view more details and redemption instructions, go to Settings > Startup Offers:

Questions about the program? Enrolling in these offers? Drop us a note at support@retool.com (also, if you'd like to feature a startup deal for your company on the Startup Offers page, apply here).

Fixes and improvements​

• Added a new event handler action type to set and clear local storage key/value pairs
• Added a toggle to the Number Input component to allow null values
• Fixed a regression that would cause the editor to crash when deleting temporary state variables
• Improved the app homepage search results to show what folders apps are in
• Fixed the "hide reset button" switch on the Wizard component
• Fixed default values and "Change" event types for the Range Slider component
• Fixed app versioning such that the editor always shows the most up to date version, even if an earlier release is published
• Added a tooltip to display the full app name on hover for the "Go to app" event handler
• Fixed the Tags component so that it can reference other queries/components (e.g. {{ .. }}) when setting tag titles
• Updated the labels for undo/redo shortcuts to be platform-specific

Check out this guide to see the on-prem versions and their release notes. These fixes and improvements will be rolling out to on-prem customers in the next few weeks.

Switching between component types​

You can now easily switch the type of a component (e.g. Button →Link), and we’ll transfer over all applicable settings like label configuration, tooltips, and more! Let's say that you’ve set up a Number Input with a default value, min/max, label, and tooltip, and then you decide you actually want your users to be able to select their value via a Slider.

Previously, you’d have to drag out a new Slider component and manually copy over each of your settings one by one. Now, all you need to do is click on the three dots menu in the component inspector (right-hand panel) and click “switch component":

For most input components, you can now switch to a preset or other similar component type (for Number Input, that’s Slider, Percent, Currency, Rating, and Range Slider). Sometimes, we’ll prompt you for additional action when we can’t automatically convert all of your settings: like when switching from a Slider to a Range Slider, you’ll have to choose start and end values. There are so many different options to try out: like switching between different styles of Buttons (Button, Outline Button, and Link)!

We’re rolling out this new functionality to all users over the next week. Additionally, we’re working on fully overhauling additional components like Select and Multiselect, so you won’t see these options on those components just yet. Let us know how “Switch component” works for you, and any other components/presets you’d like to see at support@retool.com!

Fixes and improvements​

• Improved start time when running query
• Improved performance during drag-and-drop
• Fixed an edge case where multiple queries to the same resource would occasionally fail
• Added support for plain numbers in the border radius style editor (assumes px unit)
• Fixed file parsing for the new file input component types on Windows
• Added a new option to the Text Input component to show a character count
• Improved search in the component list
• Fixed a rare edge case where the preview button in editor mode would hang indefinitely
• Fixed GraphQL queries to exclude empty optional fields
• Added support for using self-signed certificates with MongoDB connection string

Check out this guide to see the on-prem versions and their release notes. These features and performance improvements will be rolling out to on-prem customers in the next few weeks.