Skip to main content
Version: 2026.09

Folders

Folders arrange the Resources in a System's tree — for example engineering/aero/ and scratch/. A folder is layout on a branch. You create, move, and rename folders while Edit resources is open, and Save stores them as a commit. See System tree for adding and removing what the branch tracks.

  • Path-based. A folder is the path of the Resources inside it. An empty folder stays in the tree after you save.
  • Per branch. The layout belongs to the branch you are editing. Earlier commits keep the layout they were saved with.

Browse folders​

  1. Open a System and select a branch or commit.
  2. Click a folder to expand or collapse it.
  3. Click a Resource to view it in the right panel.

Create, move, and rename​

Folder changes happen while Edit resources is open. Click Save when you are done.

Create a folder

  1. In the tree, click New folder.
  2. Type a folder name and click Create.
  3. Drag Resources into the folder when you want them there. An empty folder can be saved.

Folder names can contain spaces and other characters. The platform stores them and shows the name you entered. The Python client uses an encoded path for the same names — see Folders in a System.

Move Resources

  • Drag a Resource onto a folder.
  • Select several Resources and drag them together.
  • Drop a Resource on the System root to take it out of every folder.

Nest folders

Create a folder inside another, or drag a folder into a folder, to build a path such as engineering/aero/.

Rename a folder

Rename from the tree. The dialog title is Rename folder. Every Resource in that folder, including nested folders, moves with the new name.

Save folder changes​

  1. Make the folder and Resource changes while editing.
  2. If the draft still contains archived Resources, saving stays disabled until you remove them. The banner reads Remove archived resources before saving.
  3. Click Save. Saving creates a new commit on the branch.
  4. Click Cancel to drop the draft. The System returns to its last saved state.

Required role: Editor or above on the System.

What stays the same​

  • Resource names. Moving a Resource leaves its name as it is. See Update a Resource.
  • Access. A folder does not grant or restrict access. See Sharing and Access Control.
  • History. Earlier commits keep the folder layout they were saved with.