Uploading Files#
This guide will walk you through the process of uploading files to your Materials Commons project.
Uploading Files On The Web#
This part of the guide will step you through uploading files from the Materials Commons website.
Accessing Your Project#
Navigate to the dashboard
Locate your target project in the project list
Click on the project name to enter the project space
Managing Files#
Once inside your project, you have several options for organizing and uploading files:
Creating a Directory Structure#
Before uploading, you may want to organize your files in directories:
Click the “Create Directory” button
Enter a descriptive name for your directory
Click “Create” to confirm
Click on your new directory to enter it
Tip
Choose clear, meaningful directory names that reflect the content or purpose of the files they will contain.
Uploading Files#
To begin uploading your files:
Navigate to your desired upload location (root directory or custom folder)
Click the “Upload” button
Select the files from your local system
Note
You can upload files directly to the project root, but organizing them in directories is recommended for better project management.
Important
Make sure you’re in the correct directory before starting the upload process.
Tip
Advanced Upload Options
Materials Commons provides several efficient ways to upload your data:
Using Globus to Upload Data - For large file transfers
Using The Materials Commons CLI File Uploader - For automated uploads
Uploading a Directory - For uploading entire directories in the web uploader
See our detailed File Upload Guide for complete instructions on each method.
Uploading Files Using The CLI#
Prerequisites#
Local project directory must exist (created via
mc init
ormc clone
)Default file size limit: 250MB per file
Basic Upload Commands#
# Single file upload
mc up file.txt
# Multiple files upload
mc up file1.txt file2.txt
# Recursive directory upload
mc up -r directory/
# Upload everything recursively
mc up -r .
Important Notes#
Files are automatically versioned
MD5 checksums used by default for verification
Use
--no-compare
to skip checksum checksMissing intermediate directories are created automatically
Files mirror the project’s directory structure