Skip to main content
Version: 2026.10

Directory

The Directory tab shows what the selected branch tracks: Resources, folders, and Subsystems. Editing that set and clicking Commit Changes saves a new commit on the branch. For creating branches and merging them, see Branches.

Browse the directory​

  1. Open a System and click Directory in the header. To view a different branch, switch branches first. See Branches.
  2. The tree on the left lists:
    • Subsystems, when the branch tracks other Systems
    • Tracked Resources, in folders when the branch uses them
    • Artifacts under the files they were produced from
  3. Click a Resource to open it in the main area. The tabs are Activity, Preview, Lineage, and Compare. See View a Resource.
  4. The details panel on the right shows the Resource's metadata and versions. Use Show details or Hide details to toggle it, and Expand preview to give the main area more room.

With nothing selected, the details panel summarizes the System and lists its branches under Branch/Commit History. Click a branch to switch to it.

Tree header controls:

  • Search: filter the tree by name.
  • Sort: A to Z, Z to A, Type (default), Updated, or Change.
  • ⋯ menu: Expand All Folders, Collapse All Folders, and the System actions in Manage a System.

Right-click a Resource, or use its row menu, for these actions:

  • View Resource
  • Open in New Tab
  • Copy (URL, name, link, or ID)
  • Download
  • Share
  • Rename
  • Archive
  • Remove (in edit mode)

To run a job on the selected Resource, click Create a job. See Jobs.

Select several items​

  • Hold ⌘ (Mac) or Ctrl and click to select several items.
  • Hold Shift and click to select a range.

The main area then lists the selected folders, Resources, and Subsystems, with Download, Share, and Remove.

Edit what the branch tracks​

  1. Open the Directory on the branch you want to change.
  2. Click the pencil (Edit system) in the tree header, or choose an item from the Add new (+) menu. Either one opens edit mode, and the pencil reads Editing system.
  3. Make your changes:
    • Add from the library. The Library pane opens next to the tree. On Resource Library or Systems, search and click Add, or drag an item into the tree.
    • Add new (+) menu: Resource, Subsystem, Folder, Upload File, or Connect Resources. Notebook appears when Notebooks are on.
    • Remove an item from its row menu. Undo remove brings it back.
    • Arrange Resources into folders. The Adds go to <folder> strip shows where new items will land. Click Clear add target to add at the top level instead.
  4. Click Review changes to see everything you staged under Added, Removed, and Changed. Undo single items, or use Undo all for a group.
  5. Click Commit Changes at the top of the Library pane.
  6. In Commit Changes, enter a Commit Message and click Commit Changes.

To leave without saving, click Cancel, then Discard changes.

Commit Changes is disabled when nothing is staged or when the commit would leave the System empty.

Required role: Editor or above.

Pin a version​

In edit mode, each top-level Resource has a File version selector:

  • Latest follows new versions of the Resource. Each new version shows up on the Accept changes page.
  • A specific version keeps the branch on that version.

Subsystems have a System version selector instead, with baseline or a tag. See Subsystems.

Upload files into a System​

  • Drag and drop: drag files from your computer onto the Directory. Edit mode opens.
  • From the menu: click Add new (+) > Upload File. In Add New Resources, click Choose Files.

In the Upload Resources dialog, fill in metadata such as tags and classification, then click Upload. The uploaded files are added to your changes. Click Commit Changes to save them to the branch.

To link files from an app integration instead, choose Connect Resources. See Connected sources.

Required role: Editor or above.

Accept newer versions​

When tracked Resources or Subsystems have newer versions, an Updates available (N) button appears in the page header. Click it to review the changes and Commit All. See Accept changes.

Download files​

  • One file: open its row menu and select Download.
  • Several files: select them, then click Download in the main area.
  • The whole System: use Download System in the ⋯ menu. See Download a System.

Share Resources on a branch​

Select Resources in the tree, then click Share in the main area. That opens Share selected resources. See Bulk Share Resources on a Branch.