Retool Workflows is currently in public beta for Retool Cloud organizations. Sign up to get started →
The Workflow editor is the interface you use to build workflows. It is made up of five primary areas:
- Canvas - Arrange blocks to build your workflow
- Toolbar - Add blocks, navigate the canvas, and run workflows
- Left panel - Visualize and browse blocks, functions, and run history
- Bottom panel - View run logs and toggle environments
You can return to the start of your workflow by clicking Go to Start.
The canvas is the main area of the editor and is where you build workflows. You add blocks to the canvas that perform specific actions. You can move blocks around using drag-and-drop to position them anywhere on the canvas.
Click the Fit all button in the toolbar to automatically change the zoom level to show all blocks in the visible area.
The canvas has no size constraints and you can add as many blocks as you need. You can pan around the canvas by holding Space or clicking the Pan button in the toolbar, then click-and-drag with the cursor.
You can also zoom in and out of the canvas to show more content in the visible area. Zooming out automatically collapses any existing blocks to show only their name. You can add or click on blocks at any zoom level to expand and make changes.
There are multiple ways to adjust the zoom:
- Use the Zoom controls in the toolbar
- Ctrl + / -
- Ctrl + Mouse scroll up or down
- Pinch-to-zoom with a trackpad
You can quickly return the zoom level to 100% by double-clicking on any area of the canvas or selecting 100% from the Zoom controls in the toolbar. You can also double-click a block to expand it and zoom to 100%.
The toolbar at the top of the editor contains various options for interacting with your workflow.
The Select and Pan controls allow you to select blocks and interact with them, or pan around the canvas to navigate freely. You can also expand or collapse all blocks in your workflow by clicking the Expand all and Collapse all buttons in the toolbar, and control the level of zoom.
The title area contains the workflow's name. You can click this to rename it.
Click + to add a block to the workflow, then select the block type. Move the cursor to an area of the canvas and click to place the new block.
Workflows do not run automatically by default. Once you have built a workflow and would like to run it automatically based on a schedule or webhook event, toggle Enable.
The Workflow editor automatically saves changes to your workflow but you must manually deploy changes for them to take effect. This allows you to make changes to an existing workflow without disruption.
The Workflow editor displays the current deployment status in the toolbar (e.g., Changes not deployed). To deploy all changes to the workflow since the last deployment, click Deploy.
You can also click on the dropdown button to find out when the workflow was last deployed. If you'd like to revert the workflow back to its currently deployed state, select Revert to last deployed version.
You can manually run a workflow at any time by clicking Run. When you run a workflow, it displays the current run log.
The left panel has two modes:
- Visually explore the workflow and configure functions.
- View its run history and access logs.
You can toggle between either mode using the buttons on the left of the editor, or hide the left panel entirely.
The Outline section displays a list of all blocks in the workflow. You can click on each block to show it in the canvas. As with blocks on the canvas, blocks in the Outline section include an icon that reflects their function.
The Functions section is where you configure Function blocks—reusable blocks that can be called by other blocks. Function blocks don't appear on the canvas due to their purpose and are managed in this area of the panel.
The Run History section displays run logs for a workflow and whether they ran successfully. You can click on any entry to view the run log, should you need to debug a failed workflow.
The status bar provides access to workflow logs and environment selection.
The run log appears automatically whenever you run a workflow manually or select a previous run log from the Run History section. You can also click Logs to show or hide the currently selected log.
Workflows can run using data sources set up in different environments, such as production and staging. You can select the environment in which a workflow runs from the environment select input on the right of the status bar area.
Multiple environments are available to Retool organizations on paid plans and you must configure environment settings for each resource.
You configure workflow permissions in the same way as app and resource permissions.
When configured, the Workflow editor displays a warning to restricted users that describes the access level they have.
Users with Use access can view and run workflows only, but cannot view the block contents.
Users with Edit access can edit workflows as long as they have access to all the resources used by the workflow. Edits include changes to the workflow and resource queries. Resources to which the user lacks access include a warning. This level of access allows users to view block contents.
Users with Own access have full control over workflows.
Updated 15 days ago
Learn more about automating jobs, alerts, and tasks on Retool Workflows.
- Retool Workflows
- Retool Workflows Quickstart
- Retool Workflows blocks
- Retool Workflows triggers
- Retool Workflows error handling and debugging
- Automate ETL tasks with Retool Workflows
- Automate incident notifications with Retool Workflows
- Automate metrics reporting with Retool Workflows
- Automate trial expiration offers with Retool Workflows