The App Inspector now appears when you have the Inspector open but no component selected. The App Inspector includes the following settings that were previously found in the App Settings sidebar:

• Browser title
• Custom URL
• Custom shortcuts
• Max width

The App Inspector also includes the Persist URL parameters setting, which configures search query parameters and hash parameters to persist during page navigation and when switching pages with the “Go to Page” event handler.

The directory structure for apps protected using Source Control is changing to reduce the likelihood of merge conflicts.

Component positioning information (stored in ToolScript files) is now organized by page. The apps directory contains a .positions directory, which contains one file per page in the format .pageName.positions.json.

Previously, all positioning information was stored in one .positions.json file. The new structure prevents merge conflicts.

app-name
└── .defaults.json
└── .positions.json
└── .mobilePositions.json
└── lib
  └── sqlQueryName.sql
  └── jsQueryName.js
└── src
  └── container1.rsx
└── functions.rsx
└── main.rsx
└── metadata.json

app-name
└── .defaults.json
└── .positions
  └── .global_mobile_positions.json
  └── .global_positions.json
  └── .pageName1.positions.json
  └── .pageName2.positions.json
  └── .pageName1.mobilePositions.json
  └── .pageName2.mobilePositions.json
└── lib
  └── sqlQueryName.sql
  └── jsQueryName.js
└── src
  └── container1.rsx
└── functions.rsx
└── main.rsx
└── metadata.json

A new and improved version of the Cascader component is now available on Retool Cloud and for self-hosted organizations. Retool recommends using the new component, and the legacy version will be deprecated. You can click Upgrade in the Inspector of an existing Cascader component to use the new version.

The new Cascader features:

• The ability to manually add an option list or dynamically map one to existing data.
• A new dropdown look, similar to the Select component.
• New label options (customizeable caption, color, icon).
• Options now support numeric values in addition to string values.

Some additional changes in this version include:

• The value of the new Cascader component is the value of the selected option. A new valuePath property enables you to have access to the path of values leading to the selected option.
• Option values must be unique.
• Like other modern Retool components, values for options need to be unique. If you use the one-click upgrade for Cascaders, duplicate values will have parent values appended to make them unique.
• Like Checkbox Group and Navigation, the data source is expected to be an array of objects with a property that points to its parent. Cascader nests options by parent value.

Improvements to the Navigation component are now available. When you add a Navigation component to an app with multiple pages, Retool automatically configures the menu items to map to the pages of your app. Event handlers are also preconfigured, and clicking a menu item takes you to the corresponding page.

You can still customize the Navigation component to have different behavior, if desired. Refer to the Navigation guide for more information.

This change also made retoolContext.pages and retoolContext.currentPage available. Refer to the Retool Context reference for more information.

A new and improved version of the Checkbox Tree component is now available on Retool Cloud and for self-hosted organizations.

The new Checkbox Tree features:

• The ability to use manual or mapped option lists.
• Validation rules.
• Captions, tooltips, and other customization options.
• Support for infinite nesting.

Retool now supports 15 preset chart components, eliminating the need to manually write Plotly JSON for basic chart types. This change enables users to more easily create and customize chart and graphs in their apps.

Features of the new chart components include:

• Support for multiple data sources in series-based charts.
• Data grouping and aggregation.
• Customizeable titles, legends, labels, and toolbars.
• Configurable user interactivity.
• Advanced use cases using the Plotly JSON Chart.

A new version of the Alert component is now available. It is a significant upgrade over the previous version, with new options to customize alert messaging.

You can create custom alert states that represent different alert types or severity, and configure them with the following options:

• Title and description.
• Icon, icon position, and tooltip.
• Action text to trigger event handlers on click.

Existing apps can continue to use the previous version, which is now deprecated.

A new version of the Scanner component is now available. It is a significant upgrade over the previous version, with new functionality for you to customize the scanning experience. Features include:

• Use scan events to reference scanned items and the time between scans.
• Detect duplicate scans.
• Programmatically pause after each scan or set the time between scans.

The Stack component is a container with Flexbox-like layout controls. Instead of following the standard 12-column grid layout, Stack automatically arranges nested components horizontally or vertically. You can then control the alignment and distribution of nested components and precisely adjust component size.

The Microphone component for Retool Mobile can record audio using the built-in microphone. Recordings are Base64-encoded in WebM format, and audio playback displays a progress bar and elapsed time.