Files
The Files library collects every input and output file from your jobs so you can find and reuse them without reopening each job individually.
Every file you upload as input and every result file a tool produces is stored in your Files library. Instead of hunting through individual job history pages, you can search and browse your entire file collection from one view at /app/files.
What the Files library contains
The library shows two kinds of files:
- Input files: Files you uploaded or data fetched from a database (PDB IDs, PubChem compounds) when submitting a job
- Output files: Result files the tool produced — structures, sequences, spreadsheets, logs, archives
Each file entry shows the filename, format, file size, the date it was created, the job it came from, and the tool that generated it.
Note
Files appear in the library after you run a job. Files from jobs you deleted are also removed from the library.
Finding files
Search and filter
Use the search bar to find files by filename. Results update when you press Enter or click the search icon.
Narrow results further with the filter controls:
- Format: Filter by file extension (
pdb,fasta,csv,sdf, etc.). The dropdown shows only formats present in your library. - Tool: Filter by the tool that created the files. Useful when you want all outputs from a specific tool across multiple jobs.
- Source: Show only Input files, only Output files, or both.
Sort order
The Sort dropdown controls how files are ordered in the list:
- Newest first (default): Most recently created files appear first
- Oldest first: Chronological order
- Name: Alphabetical by filename
- Largest first: Biggest files appear first
Group by
Use Group by to cluster files into sections:
- None: All files in one flat list
- Job: Files grouped by the job they belong to
- Format: Files grouped by file extension
- Tool: Files grouped by the tool that produced them
You can combine grouping with sorting and filters.
Previewing files
Click any file row to open a preview. The preview type depends on the file format:
- Text files (
.fasta,.pdb,.sdf,.cif,.json,.log, and others): Raw text shown in a scrollable panel - Images (
.png,.jpg,.svg, and others): Image displayed inline - 3D structures (
.pdb,.cif,.mmcif): Interactive Molstar structure viewer - Binary files (archives, Excel files): No in-browser preview; download directly
The preview dialog shows the filename, format, file size, and source job. You can download the file directly from the preview.
Downloading files
To download a single file, click the download icon in the file row, or click the Download button inside the preview dialog.
To download multiple files at once, select files using the checkboxes on the left, then click Download in the bulk action bar that appears at the bottom of the page.
Note
Bulk download sends each file as a separate download rather than a single ZIP archive.
Deleting files
To delete a single file, click the delete icon in the file row and confirm the deletion.
To delete multiple files, select them with the checkboxes, then click Delete in the bulk action bar.
Warning
Deleting a file permanently removes it. If you delete a file that is the sole output of a job, you cannot recover it without re-running the job.
Navigating to the source job
Each file shows which job it came from. Click the job name link in the file row to open that job's results page. This lets you review the full context — inputs, settings, all outputs — for any file in your library.
Past jobs not appearing
If you have jobs from before the Files library was introduced, those files may not appear automatically. When this applies to your account, a banner appears at the top of the Files page with an Index past jobs button. Clicking it starts a background process that indexes files from your historical jobs. This typically completes within a few minutes depending on how many past jobs you have.
Next steps
- Jobs: How job history works and how to manage individual jobs
- Quickstart: A complete walkthrough of running your first tool