Skip to main content

Changelog

Updates, changes, and improvements at Retool.

Refer to the stable and edge release notes for detailed information about self-hosted releases.

Retool made significant updates that improve Assist's app generation capabilities:

  • Improved quality of app generation. Assist has an improved ability to successfully set a wider set of properties across a wider set of components.
  • Quicker app generation. Generating an app from scratch is approximately 20% faster.
  • Better token efficiency, especially for app editing. Token use has decreased by approximately 40-50%, depending on the change type. Users will notice a decrease in the number of context window issues they encounter.
  • Improved support for building forms and using repeatable components inside apps.

This change is currently rolling out to cloud instances and will be available to self-hosted instances in an upcoming edge release.

Retool now provides a native integration for ServiceNow, an IT service management platform for managing incidents, change requests, service catalog items, and other operational workflows. You can create a resource and write queries to interact with the ServiceNow API.

READMEs can now be protected for apps that use Source Control. For existing apps that have a README, Retool will add a README.md file to your repository with your next commit. If you are protecting an app for the first time, Retool will include the README.md file automatically.

This feature is currently rolling out to cloud instances and will be available to self-hosted instances on an upcoming edge release.

As a form of feedback, you can now submit prompts from the help button. Find the help button at the bottom right of pages like the apps or resources landing page. Each prompt triggers an internal prototype generated with AI, which Retool can use to improve the product. If Retool implements the feature, you can choose to be credited with your name in the changelog.

Retool would like to thank the Conductor team, who inspired this change with their recent update.

Retool now supports hardened images, which are now available on the self-hosted stable release channel. These images are designed to improve supply-chain security, reduce the attack surface, and support modern infrastructure while remaining functionally compatible with existing deployments. Learn more about hardened images in the conceptual guide.

At this time, hardened images are supported for the tryretool/backend Docker image only. Retool plans to expand support for hardened images to tryretool/code-executor-service in the future.

Plan your migration

Use the following high-level steps to evaluate and roll out hardened images.

1. Review requirements and environment

2. Test hardened images in non-production

Retool strongly recommends testing hardened images on non-production instances first, for example:

  • A development or staging instance in a separate Virtual Private Cloud (VPC) or cluster.
  • A temporary test environment built using the Docker or Kubernetes deployment guides.

When testing:

  • Update your manifests or Docker Compose files to use the appropriate *-stable-hardened tags.
  • Verify your critical apps, workflows, and database connections behave as expected.
  • Check container health, logs, and telemetry using Container logs and Collect self-hosted telemetry data.

3. Roll out to production instances

When you're ready to use hardened images in production:

  • Follow your usual deployment and rollout process. For example, use the near-zero downtime strategy in Scale your self-hosted deployment infrastructure.
  • Upgrade instances sequentially (development → staging → production) and validate each step.
  • Communicate with your users about maintenance windows and any expected changes.

If you encounter regressions, you can temporarily roll back to classic images by reverting your image tags while you work to diagnose and resolve issues.

Stable channel timeline

Over time, hardened images will become the recommended default for production deployments, and classic images will eventually be phased out.

To stay current on timelines and support windows, monitor the Stable releases and Self-hosted requirements documentation.

Self-hosted Retool 3.334.0 is now available on the Stable release channel.

Retool releases a version on the Stable channel every 13 weeks (quarterly). 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.

Retool provides versioned product documentation for supported Stable releases. When browsing Retool Docs, use the version dropdown menu in the navbar to switch to a relevant version.

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.

Retool made significant design updates to the workflows landing page to improve user experience and align more closely with the agents landing page.

The workflows landing page was updated for cloud instances. It will be available in an upcoming edge release, and is expected in the Q2 stable release for self-hosted instances. To revert to the previous landing page experience, toggle off the Reskin workflow index page to render agents home page UI feature flag in Settings > Beta.

The landing page displays all workflows, and folders containing workflows, for your Retool organization. You can perform the following actions from the landing page:

  • Sort workflows by Name, Last Updated date, or Created date.
  • Search for workflows.
  • Toggle between Grid view or Table view.
  • Refresh the workflows list.
  • Import a workflow from JSON.
  • Create a new Folder.
  • Create a new Workflow.
  • Create a workflow From Template.

When creating a new REST API resource, you can now connect an OpenAPI or Swagger specification. Connecting an API specification enables:

  • Autocomplete: Get endpoint and parameter suggestions when writing queries.
  • Validation: Retool validates requests against the specification schema.
  • Better Assist: Assist can more effectively generate queries based on the specification.
  • Documentation: Endpoint descriptions from the specification appear in the query editor.

When working with resources, users can also manually create endpoints or parameters that aren't included in the specification.

This feature is currently rolling out to cloud instances, and it will be available in an upcoming edge release.