Self-hosted Retool stable release 3.148
Release notes for the Self-hosted Retool 3.148 stable release.
Retool releases a version on the stable channel each quarter. A stable release is generally four versions behind the cloud-hosted version at the time.
Preparation and testing of a stable version occurs approximately four weeks prior to its release. Stable releases are rigorously tested before they are published. As the release cycle is less frequent, administrators can more easily maintain and upgrade deployments.
Retool supports each stable release for six months. During this time, Retool will release patch updates that contain bug fixes or security updates. Patch updates do not contain functionality changes and can be applied more quickly than performing a full version upgrade.
After six months, a stable release is considered deprecated. You can continue using a deprecated release but it will no longer receive updates. At this time, you should upgrade to the latest stable release.
Self-hosted Retool 3.148
No longer supported
| Release | Released | Digest | |
|---|---|---|---|
| First | 3.148.23 | Jan 16, 2025 | sha256:cd36589962db14a59033858e0b704e474bfde0d2c6c55b7901a3ee7ea75f48fb |
| Latest | 3.148.32 | Aug 27, 2025 | sha256:d491cc7cd6210e545f2beeaf75dadb955c155eec943b3a7e56010ee9e0658917 |
Best practice
Subscribe to the Atom feed for 3.148 to get notified when new patch releases are available.
Major changes in this release
New features, significant changes, and any actions required when upgrading.
| Type ↕ | Change ↑ |
|---|---|
| deprecated | Deprecation of Databricks connector version 1.0 Retool has deprecated version 1.0 of the Databricks connector. |
| new | Execution modes for Workflow blocks Workflow blocks now have several execution modes. |
| improved | Improvements to Source Control for workflows Retool added support for new Source Control features on workflows, including branching, multi-element branches, and collaborative branches. |
| improved | Improvements to the command palette The Command Palette includes several improvements related to frames and page navigation. |
| improved | Improvements to the Navigation component Improvements to the Navigation component |
| new | Multi-step functions Multi-step functions |
| new | New version of the Cascader component An updated Cascader component is now available for use in Retool apps. |
| improved | OpenAI o1 available in Retool AI OpenAI o1 available in Retool AI |
| improved | Retool apps now support multiple pages by default Multipage apps |
| improved | Support for shadows in app themes Shadow styling is now available in app-level and organization-level themes. |
| improved | Test deployments for Source Control Test deployments for Source Control |
| new | Wait blocks You can now add a Wait block to a workflow. |
| 12 changes | |
Patch release notes
Bug fixes, improvements, and other incremental updates across all patch releases in this release.
| Type | Description |
|---|---|
| 3.148.301 change↑ | |
| fixed | Fixed an issue where the license status was not always checked when starting the jobsRunner. [#63707] |
| 3.148.291 change↑ | |
| removed | Removed unsupported JDBC connectors. [#64136] |
| 3.148.272 changes↑ | |
| added | Added a new security notification banner for VM2 deprecation warnings. [#63768] |
| fixed | Fixed an issue with SCIM when deactivating users with some providers like Microsoft Entra. [#63682] |
| 3.148.152 changes↑ | |
| fixed | Fixed an issue where the calendar overlay would still appear in Date Time components when readOnly is true. [#61580] |
| changed | Changed version control to lock changes for resources/queries when version control is locked. [#61638] |
| 3.148.142 changes↑ | |
| secutrity fix | Increased restrictions to only allow Admins access to the /api/organization/checkProtectedAppsRepo endpoint. [#61096] |
| fixed | Fixed an issue with IAM authentication that prevented expired Redshift passwords from automatically renewing. [#61282] |
| 3.148.133 changes↑ | |
| added | Added support for renaming and moving protected resources. [#60858] |
| fixed | Fixed an issue where certain versions of samlify caused an issue with SAML logins. [#60880] |
| fixed | Fixed a bug where removing a manifest config did not correctly set the latest version to live for multi-instance releases. [#60816] |
| 3.148.122 changes↑ | |
| security fix | Updated dompurify to the latest version. [#60507] |
| security fix | Patched CVE-2025-47949 in samlify. [#60881] |
| 3.148.112 changes↑ | |
| added | Added support for creating an app and release in the same deployment for multi-instance releases beta users. [#60383] |
| improved | Improved List Objects API to support include_inherited_access for apps. [#60630] |
| 3.148.102 changes↑ | |
| fixed | Fixed an issue where resetting a Source Control repository branch may fail. [#59216] |
| improved | Improved character support for Source Control branches of mobile apps. (#59817) [#59817] |
| 3.148.91 change↑ | |
| security fix | Fixes a security issue by sanitizing the auth header in Bitbucket error logs. Relevant for users with Bitbucket as their source control provider. [#59472] |
| 3.148.81 change↑ | |
| security fix | Added a permission check in the Retool Database migration feature [#59399] |
| 3.148.72 changes↑ | |
| fixed | Fixed an issue where a user with Use access could bulk move or delete apps. [#58844] |
| fixed | Fixed an issue with the msodbcsql18 dependency. [#59031] |
| 3.148.61 change↑ | |
| improved | Improved the privacy disclaimer in the login flow. [#58529] |
| 3.148.52 changes↑ | |
| fixed | Fixed an issue where the List View component may crash if there is a large number of instances. [#57914] |
| fixed | Fixes an issue with SAML SSO login. [#57385] |
| 3.148.41 change↑ | |
| fixed | Fixed an issue where the environment couldn`t be changed on the main branch of a protected workflow. [#57589] |
| 3.148.32 changes↑ | |
| security fix | Patched CVE-2025-29774 in xml-crypto. [#57513] |
| security fix | Patched CVE-2025-29774 in xml-crypto. [#57513] |
| 3.148.22 changes↑ | |
| added | Added the option to specify a custom entityID for SAML SSO [#57222] |
| added | Added new file upload endpoints for Slack to replace the deprecated files.upload functionality. [#57293] |
| 3.148.077 changes↑ | |
| added | Added shadow styles for components and new shadow theme properties. [#55574] |
| added | Added an error that is logged to the console if the browser fails to load JavaScript files necessary for rendering custom components. [#54951] |
| added | Added a hover tooltip for some instances of truncated text in style editors. [#54926] |
| added | Added the ability to undo and redo changes in the theme editor with keyboard shortcuts. [#55033] |
| added | Added support for localizing public apps. [#54858] |
| added | Added the ability for multipage users to add page-scoped keyboard shortcuts. These override globally-scoped custom keyboard shortcuts. [#54670] |
| added | Added border-radius style property to Listbox component. [#54650] |
| added | Added an error message to indicate rate limiting for custom components. [#54700] |
| added | Added support for multi-instance releases. This feature is in beta and can be enabled from the Settings > Beta page. Contact Support if you`d like to be added to the Beta. [#54820] |
| added | Added support for viewing and deleting registered push notification applications from Mobile Advanced Settings. [#54427] |
| added | Added a new editor option that controls whether the label text of a Button wraps (default behavior) or truncates (new option). [#54174] |
| added | Added support for localizing components into 7 languages (Enterprise plans only). [#54487] |
| added | Added metadata to the "User invited" Retool Event. [#54412] |
| added | Added support for comma separators in the Statistics component, formatted based on the browser`s locale settings. [#54593] |
| added | Added the ability to rename a query by double-clicking the query title. [#54602] |
| added | Add the api/v2/source_control/test_deploy endpoint to Retool API. [#54039] |
| added | Added style options for the Table component`s summary row. [#54297] |
| added | Added support for custom headers in the custom component CLI. [#54269] |
| added | Added support for viewing and deleting registered push notification applications from Mobile Advanced Settings. [#54427] |
| added | Added the Restore generated color option for Primary border and Secondary border in the theme editor. [#53386] |
| added | Added a confirmation modal when deleting a theme. [#53159] |
| added | Added support for Click event handlers to the Avatar component. [#53079] |
| added | Added shadow styles for components and new shadow theme properties. [#55574] |
| added | Added an error message that indicates failed manifest fetching to the Settings page. [#55546] |
| added | Added undo/redo keyboard shortcut functionality for the theme editor. [#55618] |
| added | Added support for multi-step workflows in public beta on self-hosted organizations. [#55583] |
| fixed | Fixed an issue where dragging the pop-out editor for style editors would not work. [#55083] |
| fixed | Fixes a regression where modules in "expand to fit" containers would not scroll. [#54864] |
| fixed | Fixed an issue where JIT-provisioned users were not added to the External Users group. [#55289] |
| fixed | Fixed an issue with container borders where they covered small shadows. [#55207] |
| fixed | Fixed the module tutorial close button, which was previously invisible. [#55380] |
| fixed | Fixed an issue with FIDO2 authentication redirects. [#55448] |
| fixed | Fixed focus state and layout shift for multiline contents in style editors. [#54899] |
| fixed | Fixed the MySQL connector version 2.0 to support variable assignment. [#54934] |
| fixed | Fixed an issue where margin and padding properties were not searchable in the Code search tab. [#55024] |
| fixed | Fixed an issue with loading the mobile app editor while having the SANDBOX_DOMAIN environment variable set. [#54353] |
| fixed | Fixed an issue with the Chat component not permanently removing message history. [#54685] |
| fixed | Fixed an issue with the Chat component so that the empty state is centered when the message goes to multiple lines. [#54687] |
| fixed | Fixed a bug that would cause issues with virtualization of dropdown items in a Select component when using a larger font size. [#54748] |
| fixed | Fixed an issue causing a redirect loop for 2FA-enabled logins. [#54804] |
| fixed | Fixed a bug that caused child items of disabled vertical Navigation components to be clickable when they should be disabled. [#54449] |
| fixed | Fixed a small visual regression on Checkboxes created on versions before 3.75.0. [#54406] |
| fixed | Fixed the Table toolbar grouping menu, which showed a blank input after using the setGrouping method. [#54532] |
| fixed | Fixed an issue with Source Control where pull request preview links did not correctly reflect subfolder organization. [#53832] |
| fixed | Fixed an issue where dynamic expressions could not be used in number-formatted property inputs. [#54165] |
| fixed | Fixed an issue with OAuth callbacks and Source Control. [#54240] |
| fixed | Fixed an issue where clearing a Form containing a Rich Text Editor would result in the string "null" being set as the value of the component. [#53816] |
| fixed | Fixed an issue where component names prevented editing the component. [#53917] |
| fixed | Fixed alignment of icons in the app editor. [#54071] |
| fixed | Fixed a reset branch error when using Toolscript with Source Control. [#53822] |
| fixed | Fixed an issue where overwritten Retool Storage files could not have their public access changed. [#52965] |
| fixed | Fixed an issue with the theme editor where unsaved edits were discarded if the theme was renamed. [#53539] |
| fixed | Fixed an issue with custom components where new state properties weren`t properly recognized until a full page refresh. [#53584] |
| fixed | Fix an issue with query inputs in the Query Library. [#53700] |
| fixed | Fixed an issue where the Checkbox Tree component would render without a tree layout until a user interacts with it. [#53755] |
| fixed | Fixed an issue where the Table component stops responding when editing a Tag or Tags column after using setSort(). [#53117] |
| fixed | Fixed an issue with the theme editor when referencing user colors. [#52521] |
| fixed | Fixed an issue where the Styles editor would disappear when repositioned. [#53332] |
| fixed | Fixed an issue with two-factor authentication redirects for FIDO2 users. [#55680] |
| fixed | Fixed an issue where Navigation component event handlers were disappearing when added as children to other events. [#55722] |
| improved | Improved the default settings for the Stacks component. [#53862] |
| improved | Improved the number of unnecessary query runs connected to Table pagination. [#53865] |
| improved | Improved appearance of segmented controls in the Inspector. [#54177] |
| improved | Improved the file upload error message in Retool Storage to include the maximum file size if the limit is exceeded. [#52963] |
| improved | Updated color inputs in the new Chart components to include color tokens from the theme. [#53592] |
| improved | Clarifies disabled tooltip for the "Upgrade components" menu item. [#53602] |
| improved | Improved the appearance of theme settings when there are no custom themes. [#53111] |
| improved | Improved error messaging if the environment variable SANDBOX_DOMAIN is set to an invalid URL. [#53261] |
| improved | Improved handling of circular dependencies in the theme editor. [#52961] |
| changed | Changed border radius setting to allow full border radius CSS syntax. [#55314] |
| changed | Changed the Text Input component to allow commas in URL validation. [#54544] |
| changed | Changed Button Group so that hiding a visible button no longer causes buttons in overflow menu to appear. [#54606] |
| changed | Using the Double-click row* event handler with a Table component now prevents Click row event handler actions. [#54132] |
| changed | Changed app creation options to create multipage apps by default. [#53925] |
| changed | File input components now include Retool Storage queries. [#52901] |
| changed | Summary rows and number aggregation functions in the Table component now ignore null and undefined values. [#53774] |
| changed | Changed the appearance of font family stacks in the theme editor to truncate long values. [#53337] |
| 3.148.232 changes↑ | |
| fixed | Fixed an issue where resources synced from source control would not inherit permissions from their parent folder. [#62913] |
| fixed | Fixed an issue where the UI crashed instead of showing an upgrade banner when self-hosted customers reached their maximum seat limit on Team and Business plans. [#62935] |
| 108 changes | |