---
title: "Folders and Paths support | Phase Changelog"
description: "Secrets in Phase can now be organized in folders."
url: https://phase.dev/changelog/folders-paths/
---

[Changelog](https://phase.dev/changelog/)

2024.02.17

# Folders and Paths support

Secrets in Phase can now be organized in folders.

[console](https://phase.dev/changelog/tag/console/)[cli](https://phase.dev/changelog/tag/cli/)[folders](https://phase.dev/changelog/tag/folders/)

![syncing overview](https://phase.dev/assets/images/changelog/folders-paths/console.webp)

Secrets can now be managed within folders, and will keep track of the path that they are stored under. This makes it much easier to use Phase for monorepo projects or multi-tennant use-cases. All existing secrets are given the root `/` path by default.

* * *

## Creating folders from the Phase Console

Folders can be created from the new "Create" button by opening the dropdown and choosing "New Folder"

![create folder](https://phase.dev/assets/images/changelog/folders-paths/create-folder.webp)

You can create Secrets or Folders at any path, and we've added clickable breadcrumbs to keep track of which path you are in. All existing Secrets are given the `/` path by default.

## Path support with Phase CLI

The Phase CLI also has full path support, allowing you list or inject secrets at a specified path with the `--path` flag. For example, you can list all secrets at path `/frontend` with

```bash
phase secrets list --path frontend
```

or inject secrets into your app with

```bash
phase run --path frontend <your command>
```

Here it is in action:

![cli](https://phase.dev/assets/images/changelog/folders-paths/cli.webp)

Check out the [docs](https://docs.phase.dev/cli/commands) for more information on how to use the CLI with folders and paths.

## Updated secret referencing syntax

The syntax for secret referencing has been updated to support referencing secrets at a specified path. For example, you can reference the variable `DATABASE_URL` at path `backend` with

```bash
${/backend/DATABASE_URL}
```

This can also be done across environments:

```bash
${prod./backend/DATABASE_URL}
```

Check out the [secret referencing docs](https://docs.phase.dev/console/secrets#secret-referencing) for full documentation.

## Syncing secrets from a specific path

You can also specify a path when syncing secrets to third-party services. Simply enter the complete path string when creating a sync

![syncing from a path](https://phase.dev/assets/images/changelog/folders-paths/sync-path.webp)

* * *

Folders and paths support is live on Phase Cloud and [v2.11.0](https://github.com/phasehq/console/releases/tag/v2.11.0) for self-hosted users. Upgrade to Phase CLI [v1.12.0](https://github.com/phasehq/cli/releases/tag/v1.12.0) to start working with folders and paths in your dev setup as well.

Reach out on [Slack](https://slack.phase.dev) or [GitHub](https://github.com/phasehq) for any questions or feedback on this release!

RoadmapCommunity-driven

Request a feature

We build features based on community requests and feedback. Looking for a specific feature or have a use-case in mind? Reach out to us.

[Feature request](https://github.com/phasehq/console/issues/new?template=feature_request.md)

DeploymentSelf-hosted / Cloud

Get started

## Keep your secrets

Self-host or start on fully managed Cloud in under a minute.

Self-hosted

Run Phase on your own infrastructure. Free and open source.

AI agent deployment skill

[![Docker Compose logo](https://phase.dev/assets/images/docker.svg)](https://docs.phase.dev/self-hosting/docker-compose)[![Kubernetes logo](https://phase.dev/assets/images/kubernetes.svg)](https://docs.phase.dev/self-hosting/kubernetes)[![AWS logo](https://phase.dev/assets/images/aws.svg)](https://docs.phase.dev/self-hosting/aws-eks)[![GCP logo](https://phase.dev/assets/images/gcp.svg)](https://docs.phase.dev/self-hosting/gcp)[![Azure logo](https://phase.dev/assets/images/azure.svg)](https://docs.phase.dev/self-hosting/azure)[![Railway logo](https://phase.dev/assets/images/railway.svg)](https://docs.phase.dev/self-hosting/railway)[![Raspberry Pi logo](https://phase.dev/assets/images/raspberry.svg)](https://docs.phase.dev/self-hosting/raspberrypi)

[Self-hosting guide](https://docs.phase.dev/self-hosting)

Cloud

Fully managed. From signup to your first secret in 60 seconds.

Sign up with

[Google](https://console.phase.dev/login?provider=google)[GitHub](https://console.phase.dev/login?provider=github)[GitLab](https://console.phase.dev/login?provider=gitlab)