All Stable releases of Self-hosted Retool
All release notes for the Stable channel of Self-hosted Retool
Text version of release notes for the Stable channel of Self-hosted Retool. Use the Self-hosted Retool release notes app to search and compare changes between versions.
Self-hosted Retool 3.300
Latest releaseCurrently supported
| First release version | 3.300.0 | December 03, 2025 | tryretool/backend:3.300.0-stable on Dockerhub |
| Latest release version | 3.300.1 | December 10, 2025 | tryretool/backend:3.300.1-stable on Dockerhub |
Major changes in this release
- Llama 4 model is deprecated and will be removed in a future release.
- Kimi K2 Instruct model is now available.
- Resource type restrictions are now available.
- Secrets Manager now supports multiple configurations.
- Enterprise customers can now use the Get IP Allowlist by Region endpoint to programmatically retrieve Retool's IP addresses.
- App pages can now be reordered.
- Workflow triggers can now be protected with Source Control.
- Claude Haiku 4.5 model is now available.
- Agents can now be protected with Source Control.
- Additional improvements to Assist are now available.
- Assist now supports Amazon Bedrock.
- GPT-3.5 Turbo Instruct model is deprecated and will be removed in a future release.
- The Kafka, SQS, SNS, and Tavily integrations are now generally available.
- Claude Sonnet 3.5 model is deprecated and will be removed in a future release.
Patch release notes
3.300.1 – Dec 10, 2025
added
- Added the
RESOURCE_TYPES_DENY_LISTenvironment variable to prevent users from creating and running against the provided resource types. - Added
RESOURCE_TYPES_DENY_LIST_CREATE_ONLYenv-var, which prevents users from creating new resources of specific types, but does not block queries the wayRESOURCE_TYPES_DENY_LISTdoes. - Added permission guards for resource access via Assist.
fixed
- Fixed an issue with Retool header flashing on redirect to a workspace.
- Fixed an issue with GraphQL resources where the
metadata.requestproperties may not always be correctly sanitized. - Fixed an issue with multi-instance releases so users can protect an element, create a release artifact, and update the manifest in the same PR.
- Fixed an issue where reset password confirmation emails would still be sent to users even when reset password emails are disabled in an organization.
removed
- Removed sensitive user tokens from audit logs with OAuth2 SSO.
3.300.0 – Dec 3, 2025
added
- Added a feature flag
sourceControlConfigAllowTemplatesthat enables Source Control configurations to use configuration variables and/or Secrets Manager secrets for sensitive credential fields. - Added support for drag-and-drop page reordering.
- Added a new API endpoint, Get IP Allowlist By Region, which returns Retool's whitelisted IP addresses.
- Added audit log events for Source Control deployments.
- Added support for managed key AI features when using a HTTP proxy.
- Added permission checks for page cloning.
- Added options to select either Amazon Bedrock, OpenAI, or Anthropic as the single-model provider for Assist.
- Added support for Claude Haiku 4.5.
- Added support for README interactions to Assist.
- Added the
RESOURCE_TYPES_DENY_LISTenvironment variable to prevent users from creating and running against the provided resource types. - Added support to Assist for referencing global objects in Javascript queries and transformers.
- Added automatic app name generation to empty apps when using Assist.
- Added the
RTEL_SEND_TO_RETOOL_INPUT_ALLOWLISTenvironment variable to specify which data to send to Retool's telemetry server. - Added a call to action in all single-page apps that prompts users to migrate to multipage.
- Added support for multiple configurations in Secrets Manager.
- Added web grounding support for Google Gemini models, allowing them to search the web for up-to-date information when answering queries.
- Added new beta features for Secrets Manager in on-premise instances, allowing multiple Secrets Manager configurations to be used at once (to get secrets from different providers, or from different areas within the same provider).
- Added a CTA to the homepage announcing Assist.
- Added an option to exclude Table columns from search.
- Added
cmd+ias a new keyboard shortcut to toggle the Assist panel open or closed. - Added toggling the Assist tab as an option in the command palette.
- Added OpenAPI/Swagger spec support to REST API resources, enabling structured API queries with autocompletion of endpoints and properties.
- Added more detailed response messages for insufficient user permissions when editing Agents.
- Added an empty object default for the
GET /resource_configurationsAPI endpoint. - Added one-click removal of roles from Groups.
- Added a
.focus()method for Container components. - Added an OAuth form for the RetoolAI resource page.
- Added a new, dismissable Assist call to action to the Add Component tab.
fixed
- Fixed an issue where popups may incorrectly stack on the workflow canvas.
- Fixed an issue with Assist tool call checkmark alignment.
- Fixed an issue where the Create dropdown may include duplicate links.
- Fixed an issue where the Assist prompt UI disappeared on short screens.
- Fixed an issue where the user interface didn't appear as expected when a white-labeled theme was used with Assist.
- Fixed an issue with the Assist prompt appearing incorrectly on some browsers.
- Fixed a connection error for customers with long running source control deployments.
- Fixed an issue with incorrect access level displaying to external apps on the Users page.
- Fixed an issue with query formatting in workflow blocks.
- Fixed a scrolling issue with the canvas.
- Fixed an issue that prevented protected apps from loading correctly.
- Fixed an issue where OpenAPI responses had data left out. This data is now encoded as Base64.
- Fixed an issue with Assist where navigating to a module prevented the module settings panel from opening.
- Fixed an issue that prevented the default credential provider from being utilized by SQS and SNS resources.
- Added the Retool AI Vector: Retool AI query writers (edit access) can manage vectors to the Beta settings which allows users with Retool AI edit permission to use create and manage vector documents.
- Fixed an issue where previews for draft mobile apps may not load correctly.
- Fixed an issue with branch merging and collaborative app editing.
- Fixed an issue where the Source Sontrol settings page failed to display correctly for customers with older GitHub app-based configurations.
- Fixed an issue where Assist may fail and return partially streamed Markdown results.
- Fixed an issue where collaborative editing may not function correctly with protected apps.
- Fixed an issue with skipped releases getting unpublished for users with multi-instance releases and spaces.
- Fixed an issue where apps may incorrectly report an undefined theme.
- Fixed an issue causing workflows using OAuth resources to break inside of nested workflows.
- Fixed an issue where the Query Library would show unclear error messages if proxy authentication was misconfigured.
- Fixed the
aria-labelledbyattribute for the Checkbox Group component. - Fixed an issue with branch cleanup in Source Control.
- Removed excluded libraries from workflow functions.
- Fixed an issue that could delay a Secrets Manager update for several minutes after a configuration change.
- Fixed an issue where the App IDE may fail to respond when attempting to edit a module.
- Fixed an issue with multi-spec OpenAPI resources.
- Fixed a bug in the public API when deleting workflow folders and added support for creating, updating, retrieving, and deleting agent folders.
- Fixed ordered list numbers not showing up when there are many steps in Assist's planned action.
- Fixed formatting of dynamic columns in Tables to apply to columns with an inferred type.
- Fixed the Vault integration in Secrets Manager so that it no longer incorrectly states the connection failed if the list of secrets is empty.
- Fixed an issue with OpenAPI Query Editor for Firefox which wouldn't open the dropdown when a value was already selected.
- Fixed an issue where an error from an MCP server could cause a Retool backend service to crash.
- Fixed an issue where organizations on the Free or Team plan may have limited access to Organization Themes.
- Fixed an issue with the
enableInstanceValuesproperty of List View children. - Fixed an issue where resource configuration options did not appear for calls to
/resource_configurationsfor gRPC resources. - Fixed an issue where long JavaScript queries in single-step functions were being truncated unexpectedly.
- Fixed a bug that caused a
ReferenceErrorFirebase` raw-mode queries. - Fixed issues with validation in List Views.
- Fixed an issue that prevented SSO buttons from appearing on user invite screens.
- Fixed an issue that caused flickering when scrolling through a group's members list.
- Fixed an issue that prevented a tool from appearing in the UI during agent execution if the tool had a long description (>2000 chars).
- Fixed an issue with cycling through Assist history within an Assist thread using up/down keyboard arrows.
- Fixed an issue that could cause autocomplete in resource editors not to include Secrets Manager secret names.
- Fixed an issue where old MCP resources may be set up with invalid authentication settings when auto-configuring authentication.
- Fixed an issue where non-Enterprise organizations were incorrectly shown an admin granularity banner.
improved
- Improved load times for high-latency connections.
- Updated the Email sent page.
- Improved the appearance of Assist autocomplete.
- Improved the appearance of the user login page.
- Improved the accessibility of buttons used for authentication pages.
- Improved focus states and design for improved accessibility.
- Improved granular access permissions so that users can also delete API tokens they've created.
- Improved the layout of Assist property blocks.
- Improved the header style in Assist.
- Improved accessibility experience for two-factor authentication setup.
- Improved Assist's ability to work on globally scoped JavaScript queries.
- Improved the error message in Assist when proxy authentication issues occur.
- Improved the Navigation component by exposing
persistUrlParamsas a property. - Improved app accessibility by disabling keyboard focus for tooltips.
- Improved UI in Secrets Manager settings.
- Improved Assist's ability to work with globally scoped queries and components.
- Improved the information architecture of the Groups settings page and added a separate section to display the group's roles and permissions.
- Improved custom component dev mode fetching to make the component more responsive to backend changes. A toast now appears to show when a refresh is underway.
- Improved the resource description field to expand automatically as you type.
changed
- Changed Source Control configuration forms to allow embedded expressions when appropriate, if the
sourceControlConfigAllowTemplatesflag is set. - Changed ... action menu behavior to disable it and add an explanatory tooltip if there are no actions a user can take. If a single action in a menu is disabled, a tooltip is added upon hover.
- Changed the behavior when a user tries to access a Workflow they don't have permissions for. Now they will be redirected back to the workflows landing page with an error toast.
- Changed all emails from Retool so that they use the most updated Retool logo.
- Changed behavior so that if the
snowflakeShowPopulateQueryTagOptionfeature flag is set, the Snowflake resource options now include "Automatically set QUERY_TAG on all queries". Checking this box makes Retool generate aQUERY_TAGfor every query to that resource, whose value is a JSON object with information about the resource and the source of the query. - OAuth resources are now only available when using directly invoked workflows, apps, and agent tool calls.
- Changed apps to use a default width of
100%. This reverts a previous change that made apps1200pxwide by default. - Changed workflow overage emails so that they include the organization subdomain.
- Changed Kafka, SQS, SNS, and Tavily Web Search integrations from beta to general availability.
- Changed the login page text content.
- Updated the menu options for blocks in workflow functions.
- Moved the Close button for workflow functions to the top right.
- Changed a rule so that non-admins (with proper role) can provide tokens to create custom components.
- Changed per-screen permissions to be enabled by default for Enterprise customers.
removed
- Removed the option to manually add a Response block in a workflow function since it's included by default.
- Removed Run until finished from Workflow blocks when creating functions in apps.
- Removed JavaScript and Python queries from workflow functions.
deprecated
- Deprecated the open source
llama-4-maverickAI model in favor ofkimi-k2-instruct-0905. - Deprecated the
llama-4model in the open source AI provider. This has been replaced withkimi-k2-instruct-0905. - Deprecated OpenAI's GPT-3.5-turbo-instruct model in favor of GPT-4.0-mini.
- Deprecated Claude 3.5 Sonnet in favor of Claude Sonnet 4.5.