Structured secrets

One secret made of several named, individually-typed fields, like a database's host, port, user, and password, each with its own value and history.

Updated Sep 17, 2026

A structured secret groups several related values under one name, each a named field with its own type. It suits something that is really a set of values that belong together — a database's host, port, user, and password, say. Each field is its own value with its own version history.

Create a structured secret#

  1. In an environment, select the + at the top right of the secrets table and choose Structured.

  2. Name the secret, then add a field for each value: a field name, its type, and its value.

  3. Add as many fields as you need with Add field, then create.

Each field picks its own type, and its value box matches — a code editor for a JSON field, a generator for a password field, and so on, the same controls a single-value secret uses. See Secret types for what each type accepts.

Reveal the values#

Reveal shows every field's current value together. As with any secret, each reveal is recorded in your audit log.

Change a field#

Open Edit values, choose the field to change from the picker, and set its new value. Each field keeps its own version history, so changing one field leaves the others untouched.

Rename and delete#

Rename changes the secret's name across every environment. Delete removes the whole secret — all of its fields — in the environment you are in.