Back to Docs

Project Files

Upload files for browser tests and keep files downloaded during a test run.

Use Project Settings → Files to keep files that belong to a project. You can upload a file for a test to use, or keep a file that a browser test downloads.

Upload a file

  1. Open your project and select Settings.
  2. Open the Files tab.
  3. Select Upload file, then choose a file from your computer.

The file appears in the project file list when upload finishes. The current project file-size limit is shown above the list.

docs.mechasm.ai/project-test-files.png
Project Files tab

Use an uploaded file in a test

On the test create or edit page, select Insert File next to the prompt. Choose a saved project file, then describe the upload step in your test.

For example: “Upload the selected CSV file through the import field and verify the records appear.”

Mechasm makes that saved file available to the browser test. It does not require a local file path in your prompt.

Keep files downloaded by a test

When a browser test downloads a file, Mechasm captures it in Project Settings → Files when it is within the displayed limits. The file row links back to the test run that created it.

Use this for workflows such as exporting a report, downloading an invoice, or downloading a generated configuration file. A captured file can later be downloaded from the file list or used by another test.

Preview and manage files

  • Select an image filename to preview it full screen.
  • Use the download button to download a stored file.
  • Use the delete button to remove a file from the project.
  • Search, filter by source, and sort the list to find a file quickly.

Manual uploads show who uploaded them. Captured downloads show their source test run.

Retention, limits, and repeated downloads

File settings apply to files created after the setting changes.

  • Test downloads controls how long captured browser downloads are retained.
  • Manual uploads controls how long manually uploaded files are retained.
  • Maximum file size controls the largest file a test can use or retain in this project, up to your organization limit.
  • Repeated downloads controls what happens when a test downloads the same filename again. Overwrite matching file replaces the existing captured file; Keep all copies retains every copy with a unique name.

Files that reach their retention date are removed automatically. Manual uploads set to Keep forever remain until you delete them.