Document

General Vault

General Vault stores reusable configuration values that workflows resolve at execution time. Entries can be personal or team-owned and can hold simple, JSON, or dotenv-style data.

The General Vault entry form with ownership, value type, and Secure modeThe General Vault entry form with ownership, value type, and Secure mode

Create an entry

Open General Vault, create an entry, and configure:

FieldPurpose
Vault nameHuman-readable name used to identify the stored configuration
Owner typePersonal or team scope that controls project visibility
KeyCase-sensitive name used after vault. in expressions
Value typeSimple, JSON, or dotenv-style parsing
SecurePrevents the stored value from being returned to the browser
ValueThe configuration source parsed according to the selected type

Choose a stable, descriptive key such as eventVenue or eventConfig. Keys must remain unambiguous in the selected ownership scope. Renaming or replacing a key requires updating every dependent workflow expression.

Choose a value type

TypeExample sourceReference exampleUse for
SimpleNew York Expo{{vault.eventVenue}}One string or scalar-like setting
JSON{"venue":{"city":"New York"}}{{vault.eventConfig.venue.city}}Nested structured configuration
EnvironmentAPI_BASE_URL=https://example.com{{vault.eventRuntime.API_BASE_URL}}Several dotenv-style key-value settings

Environment values follow dotenv-style KEY=value conventions. Review the dotenv format reference for quoting, comments, and multiline behavior, then test the actual value in Builders before publishing.

Validate JSON before saving it. A syntax error or unexpected nested type prevents expressions from resolving as expected.

Reference a General Vault value

Start the expression with vault, then append the entry key and any nested path:

{{vault.eventVenue}}
{{vault.eventConfig.venue.city}}
{{vault.eventRuntime.API_BASE_URL}}

A General Vault entry containing the eventVenue key and New York Expo valueA General Vault entry containing the eventVenue key and New York Expo value

In a template field, autocomplete exposes entries available to the current workflow scope:

A General Vault key suggested inside a template expressionA General Vault key suggested inside a template expression

For example:

{
  "eventVenue": "{{vault.eventVenue}}"
}

resolves to the stored value during the run. The Vault name is not part of the expression; the entry Key is.

Use Secure entries

Enable Secure for passwords, tokens, signing secrets, and other values that must be resolved only by the workflow executor. Secure entries do not return their value to the browser, and enabling Secure is irreversible for that entry.

  • Do not expect autocomplete or a settings preview to reveal a secure value.
  • Do not return the value from Code, Render, logs, errors, or a public trigger response.
  • Use a dedicated integration instead when Builders provides provider-specific credential fields and permission handling.
  • Replace a secure entry when its value must change and verify every dependent workflow.

Secure storage reduces accidental browser exposure. It does not make downstream disclosure safe if a workflow deliberately sends the secret to another service.

Rotate or remove a value

  1. Inventory workflows that reference the key.
  2. Create or update the replacement in the correct owner scope.
  3. Test each dependent workflow without logging the value.
  4. Publish updated versions where required.
  5. Remove the obsolete entry only after all references have moved.

If a workflow is imported or moved to another owner, recreate an equivalent entry in the destination scope and reconnect or update the affected configuration. Importing a schema does not copy Vault values.

Troubleshoot General Vault

  • Autocomplete does not show the key: verify spelling, capitalization, project ownership, and team access.
  • A nested value is missing: inspect the JSON or environment structure and use its exact path.
  • The value cannot be previewed: secure entries intentionally remain unavailable to the browser.
  • A copied workflow fails: create the required entry in the destination scope and verify its key and type.
  • A value appears in logs: remove the logging path, rotate the exposed secret, and retest with redacted output.

Next steps

Boilerplate Wiki - General Vault