Upload files to a stage

Choose a stage#

Files are attached to a project's stage, not the project itself. Open the project, scroll to the stages section, and pick the stage you want to upload to. If your project doesn't yet have stages, create one first or pick a project type next time you create a project.

Once you click "Upload" on a stage, the upload dialog opens and you can drag-drop or pick files from disk.

Where files go#

The destination depends on your company's storage setting:

• DigitalOcean Spaces (default). Files go to S3-compatible object storage. Vellum requests a presigned URL, you upload directly, and a `StageFileDigitalOcean` record is created with the metadata.
• Autodesk Revit Cloud. Files go to a folder inside an Autodesk hub/project structure your firm has connected. A `StageFileAutodesk` record holds the metadata.

From your point of view, both behave the same: the file appears in the stage's file list, marked as `Pending` review until someone reviews it.

Tips#

• Name files clearly — the filename is what reviewers see in the list.
• Re-uploading a file with the same name creates a new entry; older versions stay in the list with their own review history.
• If an upload fails partway, refresh and try again — incomplete uploads are not auto-retried.