Skip to main content

Self-hosted Retool 3.6

Recommended upgrade path for the new runtime

Self-hosted Retool 3.0 and later use an updated runtime that can improve app load time by 75%. The legacy runtime is no longer supported. We highly recommend users of previous versions first upgrade to Self-hosted Retool 2.123 and test the new runtime before upgrading to 3.0 or later.

Release notes for Self-hosted Retool 3.6. First released on August 10th, 2023.


  • Fixed an issue with setting the dynamic default value for the Status Component.
  • Added support for GCM encryption (using the USE_GCM_ENCRYPTION environment variable) for Workflows.


  • Fixed an issue with which regions are available while configuring Workflows with Retool-managed Temporal Cloud.
  • Fixed a bug with Config Vars in legacy Oauth2 auth for resource connectors.


  • Fixed an issue where creating a workflow from a template would fail.
  • Fixed a bug where Checkbox Group and Switch Group would drop the value of conditionally hidden options.


  • Fixed an issue with misfiring auth rotation workflows for self-hosted deployments using Retool-managed Temporal.


  • Fixed an issue where a specific configuration caused logs to be overly verbose.


  • Fixed an issue with Toolscript migrations where empty branches with no changes could fail to migrate. This scenario is resolvable by users by deleting the branches manually. See the migration guide for more details.


  • Fixed Toolscript migration error messaging in the case where a customer's main Git branch is protected from direct or force pushes. Previously, the migration would appear to succeed but silently fail to create any commits. The migration now fails clearly.
  • Removed a dependency on a deprecated third party service for user avatars


  • Added the ability to disable the out of date self-hosted installation notification feature flag.


  • Added Toolscript migration improvements.


  • Fixed Workflows copy.
  • Fixed Workflows regression introduced in 3.6.1.


  • Workflows: Added support for Retool-managed Temporal to power self-hosted Workflows. See the documentation to learn more.
  • Source Control: Release Toolscript, a new language designed to represent Retool apps and queries that is over 80% shorter than YAML and follows React-like syntax. Customers will be prompted to go through a guided migration flow - see the docs for additional info.
  • Added Source Control support for Query Library queries for Source Control with GitHub users.
  • Added the ability to use a single branch to track changes across multiple apps, modules, and queries for Source Control with GitHub users.
  • Added clickRow, doubleClickRow, deselectRow, and changeRowSelection event handlers to the Table component.
  • Added selectNextRow and selectPreviousRow to the Table component.
  • Added a Multiplayer Refresh Bar component
  • Added ability to toggle groupAdmin through SCIM.
  • Added additional autocomplete and linting scope for Table event handlers for the new code editor.
  • Added column background color options to the Table component.
  • Added new Branding settings that are available as an opt-in beta.
  • Added support for Secrets Manager and Environment Configuration Variables.
  • Added support for embedding the Scanner component in screens for Retool Mobile.
  • Added support for panning using the middle mouse button on the Workflow canvas in all modes.
  • Added the onChangeSort event handler to the new Table component.
  • Fixed HTTP error codes for requireApiParamsMiddleware.
  • Fixed useStickToBottom scroll functionality so that it only affects the innermost scroll bar.
  • Fixed an issue where Navigation components would not show app menu items when in a public app.
  • Fixed an issue where Table components would reset their selection state when re-mounted (for example, when in a Tabbed container).
  • Fixed an issue where analytics queries were numbered incorrectly due to sharing a count with transformers.
  • Fixed an issue where nonce was not getting replaced in the redirect URL in custom auth.
  • Fixed an issue where renaming or deleting a query that shares its name with a folder would affect to the folder instead.
  • Fixed an issue where the Debug Tools console may not scroll correctly.
  • Fixed an issue where the border radius style for List View components weren't applied correctly.
  • Fixed an issue where the global navigation header wouldn't show an active state when on folders or views.
  • Fixed an issue where theme-based cell text colors weren't correctly applied to the new Table component.
  • Fixed an issue with the Number Input mobile component where decimal numbers could not be entered when using iOS.
  • Fixed an issue with the Retool menu where the User menu may incorrectly appear instead.
  • Fixed an issue with the Table component where selectedRow properties may not update as expected.
  • Fixed an issue with the Table component where changing the width of a grouped column may result in unexpected behavior.
  • Fixed an issue with the Table component where reordering columns with "Include full rows in changeset array" enabled would break editable cells.
  • Fixed issue with the List View component where horizontal scrollbars may incorrectly appear.
  • Improved Source Control for Cloud enterprise organizations by enabling the feature by default.
  • Improved Source Control so that repositories are automatically populated with metadata.
  • Improved scrollToRow and selectRow APIs for the Table component to infer the target mode if not provided.
  • Improved autocomplete for plugins in the code editor for transformers.
  • Improved error handling of File Input components to include a notification if an error occurs during the onChange event.
  • Improved organization of "Show Header" and "Show Footer" controls for Container components. These are now available from the Add-ons menu.
  • Improved support for code evaluation with scope.