Secret Parameters

2 min read

Secret parameters store sensitive values you want to reuse without exposing them in plain sight. They work like regular parameters but keep their value hidden by default, which makes them a good fit for credentials, tokens, and other confidential data.

Use secret parameters when a value needs to be reusable across your work but should stay protected from casual view.

Secret vs. Regular Parameters

Secret parameters share the same structure as regular parameters:

A Name
A Description
A Value

The key difference is how the value is handled. With a regular parameter, the value is shown directly. With a secret parameter, the value is masked by default and only revealed when you choose to view it.

Secret parameters can be managed at the workspace level (Workspace Secret Parameters) or the project level (Project Secret Parameters), depending on where you open them.

Opening Secret Parameters

To open secret parameters:

Open a workspace, or open a project for project-level parameters.
Open the secret parameters area.
Review the list of secret parameters.

The page lists each parameter’s Name, Description, Value, usages, and available actions. At the workspace level, a Scope column also shows whether a parameter applies to all projects or a specific set of projects.

Hiding and Showing Values

Secret parameter values are masked by default and shown as dots in the Value column.

To reveal or hide a value:

Find the parameter in the table.
Select the eye toggle in the Value cell.
Select the toggle again to mask the value once you are done.

This lets you confirm a value when needed while keeping it hidden the rest of the time.

Finding Secret Parameters

To locate a specific parameter, you can:

Search by parameter name.
At the workspace level, filter by project.
Sort by Name or Description.

Use Clear to reset the active filters.

Creating and Editing

If your role allows it, you can:

Create a secret parameter using Create Secret Parameter.
Edit an existing secret parameter using its Edit action.

When creating or editing, you provide the name, description, and value just like a regular parameter, while the value remains protected in the list.

Permissions

Creating and editing secret parameters depends on your permissions. If the create or edit actions are unavailable, your role may not include the required access.