Skip to main content

Self-hosted Retool 3.8

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.8. First released on August 24th, 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 where creating a workflow from a template would fail.


  • Fixed an issue with mobile app creation for organizations that have not configured Retool Database.


  • Fixed an issue with Toolscript serialization of table group and summary aggregations.


  • Added support to track changes across multiple apps, modules, and queries in Source Control by default.
  • Fixed an issue where color picker theme styles were not adopting from app themes.
  • Fixed an issue with misfiring auth rotation workflows for self-hosted deployments using Retool-managed Temporal.


  • Fixed an issue with the color picker theme not inheriting settings from app theme.
  • Turned multi-element branching on by default.


  • Fixed an issue where hex codes didn’t work for the theme editor.


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


  • Fixed an issue where legacy table styles weren’t properly applied.
  • Fixed an issue where the new IDE downgrade modal displayed the wrong deadline date for downgrading by.


  • Added a new code editor for JSON.
  • Added a summary row to the Table component.
  • Added an options parameter to fileUtils.parseXLSX.
  • Added evaluation results for {{ }} Retool variables in Transformers.
  • Added links to Retool's Terms of Service for customers and users.
  • Added option to the Table component to toggle whether hidden column data is included when exporting data.
  • Added support for aggregate cells with grouped rows to the Table component.
  • Added support for dynamic columns to the Table component.
  • Added support for referencing currentRow in a Table column's status indicator.
  • Added the ability to resize columns in the results pane for Retool Workflows.
  • Added the ability to set a default region on an organization and override it for individual resources.
  • Added the option to toggle whether to log in with Google or username and password.
  • Fixed an issue where imported queries may not function correctly in some circumstances.
  • Fixed an issue where certain template expressions caused incorrect dependencies.
  • Fixed an issue where increasing the number of instances in a nested list view would cause components to render incorrectly.
  • Fixed an issue where lint errors in code editor template strings would incorrectly display.
  • Fixed an issue where organizations using two-factor authentication could have issues allowing users to automatically join.
  • Fixed an issue where queries that don't support Extract to Query Library would still display the option.
  • Fixed an issue where scrolling a component may cause the viewport to scroll as well.
  • Fixed an issue where the Table component's overflow tooltip would unnecessarily show.
  • Fixed an issue where the Tabs component may not overflow correctly if margin is set to none.
  • Fixed an issue where the branding page was being incorrectly shown to organizations on certain plans.
  • Fixed an issue where timestamps for Firestore resources were not standardized.
  • Fixed an issue where tooltips would not display correctly.
  • Fixed an issue with code editor validation for color inputs in the Table component.
  • Fixed an issue with encryption for config variable values.
  • Fixed an issue with the Table component that prevented switching the to progress format.
  • Fixed an issue with the size of Text Input components when marginType is none.
  • Improved AI Assist to correctly reference values from Global objects.
  • Improved OpenAI queries when used with transformers so AI-generated code automatically wraps variables using {{ }}.
  • Improved property browsing for Global objects.
  • Improved syntax highlighting on various components.
  • Improved the functionality of autocomplete in the code editor.
  • Improved the responsiveness of the Header frame.
  • Public apps are now enabled by default for Retool Cloud organizations on the Enterprise plan.
  • Upgraded the version of Node.js used by the Retool backend to v18.17.0.