Skip to main content
Version: 2026.10

Folders

Folders arrange the Resources in a System's directory. Examples are engineering/aero/ and scratch/. A folder is layout on a branch. You create, move, and rename folders in edit mode, and Commit Changes saves them as a commit. See Directory 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 commit.
  • 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 click Directory.
  2. Click a folder to expand or collapse it. Expand All Folders and Collapse All Folders are in the tree header's ⋯ menu.
  3. Click a Resource to view it.

Create, move, and rename​

Folder changes are staged in edit mode until you commit them.

Create a folder

  1. Click Add new (+) > Folder. This opens edit mode if it isn't open already.
  2. In New folder, enter a Folder name and click Create.
  3. Drag Resources into the folder. An empty folder can be committed.

To create a folder inside another, open the folder's row menu and choose Add New > Folder.

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.
  • Drag a folder into another folder to nest it. If the target already has a folder with the same name, confirm Merge folders to combine them.

Rename a folder

Open the folder's row menu and choose Edit Name. In Rename folder, enter the new name and click Rename. Everything in the folder, including nested folders, moves with the new name.

Remove a folder

Open the folder's row menu and choose Remove. If the folder holds files, choose one:

  • Move contents up to keep the files in the parent folder
  • Remove files to remove them along with the folder

Save folder changes​

  1. Make your folder and Resource changes in edit mode.
  2. Click Commit Changes, enter a Commit Message, and click Commit Changes. This creates a new commit on the branch.
  3. To drop your changes instead, click Cancel, then Discard changes. The System returns to its last commit.

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.