Infisical is the open-source platform for securing secrets, certificates, access, and AI Agents.
TypeScript acmeagentsai-agentscertificate-managementdevsecopsenvironment-variableskubernetesopen-sourcepampkipostgresprivate-caprivileged-access-managementsecret-managementsecret-managersecretssecrets-managementsecuritysecurity-toolsvault
docs(secrets-mgmt): document nested JSON import as folders (#8583)
mintlify[bot]1bbecdfbb07f
diff --git a/docs/documentation/platform/secrets-mgmt/project.mdx b/docs/documentation/platform/secrets-mgmt/project.mdxindex 7a28b0dc94..79d87889a3 100644--- a/docs/documentation/platform/secrets-mgmt/project.mdx+++ b/docs/documentation/platform/secrets-mgmt/project.mdx@@ -67,6 +67,8 @@ In a new project, you can fill the dashboard in one go by dropping a `.env`, `.j+To upload more secrets later, select **Add New** > **Upload Secrets**, then upload a file or paste its contents.+To delete a secret, hover over it, select the three dot menu on the right, then select **Delete Secret**.@@ -75,6 +77,21 @@ To delete several secrets at once, select their checkboxes, then select **Delete+### Import nested JSON as folders++If the JSON you upload or paste through [Upload Secrets](#secrets) contains nested objects, the review step shows an **Import Nested Objects as Folders** toggle below **Overwrite Existing Secrets**. The toggle is off by default. With the toggle off, top-level keys with `null` values are skipped. Each other top-level key becomes one secret, and Infisical stores nested objects as JSON strings.++If you turn the toggle on:++- Each nested object becomes a folder inside the path you're uploading into (Infisical reuses folders that already exist)+- Each value in a nested object that isn't itself an object becomes a secret in that object's folder+- Arrays are stored as JSON strings, `null` as an empty value, and numbers and booleans as text+- **Overwrite Existing Secrets** still decides whether secrets that already exist are updated or skipped++For example, `{"data": {"item1": {"item2": "some-value"}}}` creates the secret `item2` with the value `some-value` in the folder `/data/item1`.++Folder names can only contain letters, numbers, dashes, and underscores (up to 255 characters). Secret keys can't be empty or contain a colon or forward slash. If any key breaks these rules, the review step lists it, and you can't upload until you fix the JSON.+### SearchTo find a secret by name, type into the search bar.