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#

  1. Navigate to the dashboard

  2. Locate your target project in the project list

  3. 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:

  1. Click the “Create Directory” button

  2. Enter a descriptive name for your directory

  3. Click “Create” to confirm

  4. 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:

  1. Navigate to your desired upload location (root directory or custom folder)

  2. Click the “Upload” button

  3. 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:

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 or mc 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 checks

  • Missing intermediate directories are created automatically

  • Files mirror the project’s directory structure