Managing Multiple Environments and Secret Keys for Retool Workflows

Context:
We have multiple environments. For example, stage and production. Sometimes we need to modify or test a workflow without affecting production. While we can publish versions, we’d like to test changes in one environment first and then promote them to production.

Issue:
It seems that Retool workflows don’t support maintaining multiple active versions or environment-specific configurations. While resources can have environments, workflows themselves can only have a single version at a time. Additionally, each Retool webhook used to trigger workflows generates a different secret key, even when both workflows belong to the same environment. This makes secret management more difficult.

Current Approach:
We’re creating separate workflow instances to handle this setup:

  • Stage workflow 1

  • Production workflow 1

  • Stage workflow 2

  • Production workflow 2

This allows us to:

  • Have different webhook URLs for each environment

  • Modify resource details in one environment without affecting the other

Questions:

  1. Is there a recommended or built-in way to manage multiple workflow versions or environment-specific configurations without duplicating workflows?

  2. Is there a way to define or reuse a single webhook trigger API secret for multiple workflows, or to manage it through Retool’s configuration variables, to simplify secret maintenance?

Hi @fandrade,

You can configure multiple environments in your Resources first (e.g., “Production” and “Staging”).

Then, in your Workflow, use the Environment selector at the top to toggle between them.

Currently, only one environment can run per Workflow version. If you need to keep Production running while testing a new version, the best practice is to duplicate the Workflow, point it to your staging environment, and swap them when ready to go live.

Workflows don’t yet support dynamic environment variables, so credentials and API keys must live in each environment’s resource configuration.

Not ideal—but that’s the supported method for now until Retool adds native environment switching for Workflows.

1 Like