Retool recommends using the Form component as it's more versatile for most use cases. Use the JSON Schema Form component only if your use case requires it. Refer to the comparison of form components for more details.

Guide

Getting started with the Key Value component

Learn how to display data in key-value pairs.

Guide

Getting started with the Table component

Learn how to display and interact with data using tables.

Guide

Getting started with the Timeline component

Learn how to use the Timeline component to display date information in a Gantt chart format.

Guide

Getting started with the Wizard component

Learn how to build a step-by-step interface with multiple paths using the Wizard component.

Guide

Google Analytics query tutorial

Learn how to interact with your Google Analytics integration.

Tutorial

Google Sheets query tutorial

Learn how to read and write data to Google Sheets.

Tutorial

Group components with containers

Learn how to group components into multi-view interfaces.

Guide

HTML

A content area to embed HTML and CSS markup.

Reference

IFrame

A content area to embed a web page.

Reference

Import and export classic apps

Learn how to import and export classic apps.

Guide

Import and run a workflow from an app

You can run Retool Workflows from apps and classic apps. This is useful for reducing complexity as it enables you to:

Guide

Insert CSV data into a database

Learn how to build an app that writes a CSV file to a database.

Tutorial

Integration components for classic apps

UI elements for integrating third-party services and content in classic apps.

Reference

Interact with files

Learn how to store and retrieve files on data stores.

Guide

Interaction and navigation

Learn how to structure your classic app for user interactivity, and how to trigger and handle events.

Guide

Internationalization

Learn how to enable localization for your classic apps.

Concept

Introduction to classic apps

Learn about the fundamental concepts of classic apps.

Concept

JavaScript

Write JavaScript in Retool.

Concept

JavaScript libraries

Reference documentation for available JavaScript libraries.

Reference

Jira query tutorial

Learn how to read and write data to Jira.

Tutorial

JSON Editor

An interface to edit and validate JSON.

Reference

Keep branches up to date with branch merging

Learn how to use branch merging and resolve merge conflicts when using Source Control.

Guide

Layout and structure

Learn how to arrange components in your classic app.

Guide

Legacy and deprecated components

Learn about legacy and deprecated components.

Concept

Localize classic apps

Learn how to localize your Retool applications.

Guide

Manage Source Control branches

Learn how to view, edit, delete, and switch Source Control branches.

Guide

Microsoft Teams query tutorial

Learn how to query teams, channels, chats, and messages in Microsoft Teams.

Tutorial

Module best practices

Best practices for building modules.

Concept

Modules

A collection of components and code.

Reference

Multi-instance development with Source Control

Learn more about using multiple instances of your deployment with Source Control.

Concept

Multi-instance releases

Learn about multi-instance releases and how they differ between apps and classic apps.

Guide

Multi-instance releases for classic apps and workflows

Learn how to create and manage releases across instances

Guide

Multiplayer

Learn about collaborative classic app building for real-time development.

Concept

Navigational components for classic apps

Navigational menus and UI elements for classic apps.

Reference

Notifications

Learn more about notifications and their global settings.

Concept

Number input components for classic apps

Number input fields for classic apps.

Reference

Observability

Learn how to run tests and report errors.

Guide

OneSignal query tutorial

Learn how to send notifications and manage devices in OneSignal using Retool queries.

Tutorial

Password

An input field to enter a password.

Reference

Preload custom JavaScript code and libraries

Learn how to preload custom JavaScript and libraries in apps.

Guide

Preloaded JavaScript libraries

Information about third-party JavaScript libraries preloaded for use in web apps.

Reference

Prepared statements

Learn how Retool uses prepared statements for SQL queries.

Concept

Presentation and styling

Learn how to display information and visual components.

Guide

Presentation components for classic apps

UI elements to display content in classic apps.

Reference

Preview and share classic apps with users

Learn how to preview and share classic apps with users.

Guide

Programming paradigms at Retool

Learn about the programming styles supported by Retool and their use.

Concept

Protect classic apps with Source Control

Learn how to make changes to classic apps protected with Source Control.

Guide

Queries and code concept guides

Learn about relevant features, functionality, and principles related to queries and code.

Queries and code documentation

Write functional code to power classic apps and workflows.

Queries and code example tutorials

Hands-on guides for example usage of queries and code.

Tutorial

Queries and code how-to guides

Step-by-step instructions for common queries and code usage.

Queries and code quickstart

Learn about the fundamental concepts of queries and code.

Quickstart

Queries and code reference

Reference documentation for queries and code.

Queries and code tutorials

Hands-on guides for writing queries and code.

Query and code glossary

Learn the meanings of query and code-related terms.

Reference

Query caching

Learn more about caching query results to increase app performance.

Concept

Query GraphQL APIs

Learn how to query GraphQL APIs.

Guide

Query JSON data with SQL statements

Learn how to use SQL statements to query JSON data.

Guide

Query Library

Learn more about creating and sharing queries with the Query Library.

Concept

Query performance

Learn about query performance at different stages.

Concept

Query performance best practices

Learn about the best practices for writing performant queries.

Concept

Query REST APIs

Learn how to connect and query REST APIs in Retool.

Guide

Read data from SQL databases

Learn how to construct queries to retrieve data from SQL databases and similar data stores.

Guide

Record classic app user sessions with Fullstory

Learn how to capture user classic app behavior for use with Fullstory.

Guide

Reference dates and times in components

Learn how to reference dates and times in various components.

Guide

Repeatable components for classic apps

UI elements to build repeatable groups of components in classic apps.

Reference

Resource query tutorial

A hands-on introduction to querying resources.

Tutorial

RethinkDB query tutorial

Learn how to read, insert, update, and delete documents in RethinkDB.

Tutorial

Retool Classic CLI reference

A command-line tool for interacting with Retool.

Reference

Row-level security

Learn about row-level security of database tables.

Concept

Salesforce query tutorial

Learn how to read and write data to Salesforce.

Tutorial

Select input components for classic apps

Value selection input fields and UI elements for classic apps.

Reference

SendGrid query tutorial

Learn how to send email and manage contacts with SendGrid.

Tutorial

Share data between classic app pages

Learn how to pass data between pages in classic apps.

Guide

Share queries with the Query Library

Learn how to import and export queries with the Query Library.

Guide

Share your classic apps externally

Share your classic apps with users outside your organization.

Concept

Shopify GrapQL query tutorial

Learn how to interact with Shopify GraphQL data.

Tutorial

Slack query tutorial

Learn how to send messages and manage channels in Slack.

Tutorial

SMTP query tutorial

Learn how to send email using an SMTP resource.

Tutorial

Special input components for classic apps

Specialized input fields and UI elements for classic apps.

Reference

Store temporary data with variables and localStorage

Learn how to temporarily store data for apps.

Guide

Stripe query tutorial

Learn how to query Stripe data in Retool, including auto-pagination and common payment operations.

Tutorial

Tavily query tutorial

Learn how to search the web with Tavily in Retool.

Tutorial

Testing best practices

Best practices for testing classic apps.

Concept

Text Area

An input field to enter multiple lines of text.

Reference

Text input components for classic apps

Text input fields for classic apps.

Reference

The Alert component for classic apps

A message box to display important information with optional title and clickable action.

Reference

The Alert component for classic apps

A message box to display important information with optional title and clickable action.

Reference

The Annotated Text component for classic apps

An interface to display and annotate text.

Reference

The Auth Login component for classic apps

A button to perform custom authentication for an API resource.

Reference

The Avatar component for classic apps

A content area to display user information and profile image.

Reference

The Avatar Group component for classic apps

A group of avatars to display information and profile images for users.

Reference

The Bar Chart component for classic apps

A content area to display bar charts.

Reference

The Bounding Box component for classic apps

An interface to display a bounding box and tag areas of an image.

Reference

The Breadcrumbs component for classic apps

A secondary navigation menu to trigger actions.

Reference

The Bubble Chart component for classic apps

A content area to display bubble charts.

Reference

The Button component for classic apps

A button to trigger actions when clicked.

Reference

The Button Group component for classic apps

A group of buttons to trigger actions when clicked.

Reference

The Button Group component for classic apps

A group of buttons to trigger actions when clicked.

Reference

The Calendar component for classic apps

A content area to display calendar events.

Reference

The Calendar Input component for classic apps

An input field to select a specific date on a calendar.

Reference

The Cascader component for classic apps

An input field to select options using a dropdown menu or manually enter a value in a multi-level tree structure.

Reference

The Chart component for classic apps

A content area to display charts.

Reference

The Checkbox component for classic apps

An input field to toggle a boolean value.

Reference

The Checkbox Group component for classic apps

A group of checkboxes to toggle boolean values.

Reference

The Circular Image component for classic apps

A content area to display a circular image.

Reference

The Close Button component for classic apps

A button with preconfigured icon that trigger actions when clicked.

Reference

The Collapsible Container component for classic apps

A container to group other components with a preconfigured collapsible body area.

Reference

The Color Input component for classic apps

An input field to select a color.

Reference

The Comment Thread component for classic apps

An interface to display and enter comments.

Reference

The Container component for classic apps

A container to group other components together with flexible layout controls.

Reference

The Currency component for classic apps

An input field to enter a monetary number value.

Reference

The Current User object

Information about the current logged-in or authenticated user of the classic app.

Reference

The Date component for classic apps

An input field to select or enter a date.

Reference

The Date Range component for classic apps

An input field to select or enter a date range.

Reference

The Date Time component for classic apps

An input field to select or enter a date and time.

Reference

The Day component for classic apps

A dropdown menu and input field to select or enter a day.

Reference

The Divider component for classic apps

A content area to display a dividing line with optional label.

Reference

The Drawer frame

A container that slides in from the side of the viewport.

Reference

The Dropdown Button component for classic apps

A dropdown menu with buttons to trigger actions when clicked.

Reference

The Editable Number component for classic apps

A click-to-edit input field to enter a number.

Reference

The Editable Text Area component for classic apps

A click-to-edit input field to enter multiple lines of text.

Reference

The Editable Text component for classic apps

A click-to-edit input field to enter a single line of text.

Reference

The Email component for classic apps

An input field to enter an email address.

Reference

The Event List web component

A content area to display a list of events.

Reference

The File Button component for classic apps

A button to select single or multiple files.

Reference

The File Dropzone component for classic apps

A drag-and-drop area to select single or multiple files.

Reference

The File Input component for classic apps

An input field to select single or multiple files.

Reference

The File Utils JavaScript library

JavaScript methods for parsing and uploading files.

Reference

The Filter component for classic apps

An interface to define filters for Table components.

Reference

The Form component for classic apps

A form to group and submit input fields.

Reference

The Funnel Chart component for classic apps

A content area to display funnel charts.

Reference

The Grid View component for classic apps

A repeatable grid of components with values that map to a list of data.

Reference

The Heat Map component for classic apps

A content area to display heat maps.

Reference

The Icon component for classic apps

A content area to display an icon.

Reference

The Icon Text component for classic apps

A content area to display an icon with accompanying text.

Reference

The Image component for classic apps

A content area to display an image.

Reference

The Image Grid component for classic apps

A content area to display images in a grid layout.

Reference

The JSON Explorer component for classic apps

A content area to display JSON data with collapsible nodes.

Reference

The JSON Schema Form component for classic apps

A JSON-defined form to group and submit input fields.

Reference

The Key Value component for classic apps

A content area for viewing and editing key-value data.

Reference

The Key Value component for classic apps

Display key-value information.

Reference

The Line Chart component for classic apps

A content area to display line charts.

Reference

The Link Card component for classic apps

A container preconfigured with an icon and text.

Reference

The Link component for classic apps

A link to trigger actions when clicked.

Reference

The Link List component for classic apps

A group of links to trigger actions when clicked.

Reference

The List View component for classic apps

A repeatable list of components with values that map to a list of data.

Reference

The Listbox component for classic apps

An input field to select an option from a list.

Reference

The LLM Chat component for classic apps

An interface for AI chat conversations.

Reference

The localStorage object

Store and retrieve data in the browser.

Reference

The Looker component for classic apps

A content area to display a Looker dashboard.

Reference

The Mapbox Map component for classic apps

A content area to embed a map with custom locations.

Reference

The Microphone component for classic apps

A button to record audio.

Reference

The Mixed Chart component for classic apps

A content area to display mixed charts.

Reference

The Modal frame

A container that appears above other content.

Reference

The Month component for classic apps

A dropdown menu and input field to select or enter a month.

Reference

The Multiselect component for classic apps

An input field to select multiple options using a dropdown menu or manually enter values.

Reference

The Multiselect Listbox component for classic apps

An input field to select multiple options from a list.

Reference

The Navigation component for classic apps

A primary navigation menu with nested items to trigger actions.

Reference

The Number Input component for classic apps

An input field to enter a number.

Reference

The Outline Button component for classic apps

A button to trigger actions when clicked.

Reference

The Page Input component for classic apps

An input field to jump to a specific page of data.

Reference

The Pagination component for classic apps

A navigation menu to jump to a specific page of data.

Reference

The PDF component for classic apps

A content area to embed a PDF.

Reference

The Percent component for classic apps

An input field to enter a percentage number value.

Reference

The Phone Number Input component for classic apps

An input field to enter a phone number.

Reference

The Pie Chart component for classic apps

A content area to display pie charts.

Reference

The Plotly JSON Chart component for classic apps

A content area to display custom charts.

Reference

The Progress Bar component for classic apps

A content area to display a horizontal progress bar.

Reference

The Progress Circle component for classic apps

A content area to display a circular progress bar.

Reference

The QR Code component for classic apps

A content area to display a QR code.

Reference

The Query object

Query information and data.

Reference

The Radio Group component for classic apps

A group of radio buttons to select a single value.

Reference

The Range Slider component for classic apps

An input field to select a range of number values.

Reference

The Rating component for classic apps

An input field to select a rating.

Reference

The Reorderable List component for classic apps

A content area to display a list of text items that can be reordered when dragged.

Reference

The Retool Context object

Information about the current classic app.

Reference

The Rich Text Editor component for classic apps

An input field to enter text with rich formatting.

Reference

The Sankey Chart component for classic apps

A content area to display sankey charts.

Reference

The Scanner component for classic apps

An interface to scan a barcode or QR code using the device's camera.

Reference

The Scatter Chart component for classic apps

A content area to display scatter charts.

Reference

The Segmented Control component for classic apps

A segmented button to select an option from a list.

Reference

The Select component for classic apps

An input field to select an option using a dropdown menu or manually enter a value.

Reference

The Sidebar frame

A container that renders on the left-side of the viewport.

Reference

The Signature component for classic apps

An input field to digitally capture a signature as an image.

Reference

The Slider component for classic apps

A slider to select a number value.

Reference

The Spacer component for classic apps

An empty area to add space between components.

Reference

The Sparkline component for classic apps

A content area to display sparklines.

Reference

The Split Button component for classic apps

A dropdown menu with buttons to trigger actions when clicked.

Reference

The Split Pane frame

A container that divides the viewport into two resizable panes.

Reference

The Stack component for classic apps

A container to group other components together in a flexbox layout.

Reference

The Stacked Bar Chart component for classic apps

A content area to display stacked bar charts.

Reference

The Statistic component for classic apps

A content area to display primary and secondary number values with optional trend indicators.

Reference

The Status component for classic apps

A content area to display a status indicator.

Reference

The Stepped Container mobile component

A container to group other components into a series of steps.

Reference

The Steps component for classic apps

A group of steps that trigger actions when clicked.

Reference

The Stripe Card Form component for classic apps

An embedded Stripe card form.

Reference

The Sunburst Chart component for classic apps

A content area to display sunburst charts.

Reference

The Switch component for classic apps

An input field to toggle a boolean value.

Reference

The Switch Group component for classic apps

A group of switches to toggle boolean values.

Reference

The Tabbed Container component for classic apps

A container to group other components into tabbed views.

Reference

The Table component for classic apps

A table to display data that can be sorted, filtered, paginated, and edited.

Reference

The Tableau component for classic apps

A content area to display a Tableau visualization.

Reference

The Tabs component for classic apps

A group of tabs that trigger actions when clicked.

Reference

The Tags component for classic apps

A content area to display a set of tags.

Reference

The Text component for classic apps

A content area to display Markdown text or HTML content.

Reference

The Text Input component for classic apps

An input field to enter a single line of text.

Reference

The Theme object

Information about the current classic app theme.

Reference

The Time component for classic apps

An input field to select or enter a time.

Reference

The Timeline web component

Display a Gantt chart of events.

Reference

The Timer component for classic apps

A button to record elapsed time.

Reference

The Toggle Button component for classic apps

A toggle button to trigger different actions when clicked.

Reference

The Toggle Link component for classic apps

A toggle link to trigger different actions when clicked.

Reference

The Tools JavaScript library

JavaScript methods to reformat data.

Reference

The Treemap component for classic apps

A content area to display treemaps.

Reference

The URL component for classic apps

An input field to enter a URL.

Reference

The Url object

Information about URL query and hash parameters currently in use.

Reference

The Utils JavaScript Library

JavaScript methods for interacting with apps.

Reference

The Variable object

Variables that store temporary state.

Reference

The Video component for classic apps

A content area to display a video.

Reference

The Viewport object

Information about the canvas size in the current viewport.

Reference

The Waterfall Chart component for classic apps

A content area to display waterfall charts.

Reference

The Wizard component for classic apps

A container for a series of steps with multiple branches and outcomes.

Reference

The Year component for classic apps

A dropdown menu and input field to select or enter a year.

Reference

Toolscript

Learn how Retool uses Toolscript to serialize apps.

Concept

Transform data with JavaScript

Learn how to write JavaScript to manipulate data.

Guide

Usability features

Learn more about usability features.

Concept

Use Retool custom component library

Learn how to use the Retool custom component library with your custom component.

Guide

Use TypeScript API to configure custom components

Learn how to configure custom React components with TypeScript API.

Guide

Validate inputs and forms

Learn how to validate forms and input components.

Guide

Version and release classic apps

Learn how to version classic apps or revert changes to a previous state.

Guide

Write and run JavaScript

Learn how to run JavaScript in your Retool apps.

Guide

Write data to SQL databases

Learn how to construct queries to safely write data to SQL databases and similar data stores.

Guide

Write queries and code with Ask AI

Learn how to generate, edit, and fix queries with Ask AI.

Guide

Write WebDriver tests

Learn how to write Cypress and Playwright tests against your classic apps.

Guide