CSV Metadata Upload

In addition to embedding metadata into your files and updating metadata on the Add Data page, a CSV file can also be used to add metadata to your files. Follow this two-step process to prepare and upload a CSV file to quickly add metadata to your Vecteezy uploads!

Step 1: Prepare your CSV file

To prepare a CSV for upload, there are three options to get started. If you already have your CSV prepared, skip to step 2.

1. Option 1: Download a CSV from Add Data (the best option for updating metadata using a CSV after files are uploaded to Vecteezy)
2. Option 2: Download the example CSV file (the best for getting started quickly when updating metadata via FTP)
3. Option 3: Create a CSV file from scratch following our guidelines (best for experienced contributors uploading metadata via FTP)

Option 1: Download a CSV file from Add Data

Watch how to download and prepare a CSV file from Add Data, here.

Downloading a CSV file from Add Data is the best option for adding metadata using a CSV after files are uploaded to Vecteezy, expedites the process by pre-populating filenames and metadata already present in your files, and ensures high accuracy during upload. To get started with a CSV downloaded from Add Data:

1. Log in to your contributor account.
2. Go to the Add Data page
3. Click on "CSV"
4. Select "Download CSV" 
5. You will be emailed a CSV file. Please allow a few minutes for email delivery especially if you have a lot of files. 
6. Download the CSV file from your email.
7. Open it using your favorite spreadsheet program, like Google Sheets, Excel, or Numbers. Filenames and current metadata will be pre-populated.
8. Modify and add information under the headers Title, Description,Keywords, and License, as desired.
9. Save your file as a .csv
10. Continue to Step 2: Upload your CSV file.

Option 2: Download the example CSV file

Watch how to download and prepare the attached example CSV, here. 

Downloading the example CSV file is the best option for adding metadata when files are uploaded, by using FTP. To create a CSV using the example file:

1. Download the example file attached to the bottom of this article
2. Open it using your favorite spreadsheet program, like Google Sheets, Excel, or Numbers.
3. Add your filenames to each row, under the first column named Filename. These must match exactly for your file to process efficiently. 
4. Next, add your desired  Title, Keywords, Description, and License in each row, corresponding to the correct filename. 
5. Save your file as a .csv

Option 3: Create A CSV From Scratch

Watch how to prepare a CSV from scratch, here. 

Creating a CSV from scratch is a secondary option for contributors familiar with CSV uploading. To Create a CSV from scratch:

1. Using your favorite spreadsheet program, like Google Sheets, Excel, or Numbers, open a blank spreadsheet
2. In the first row, add the column namesFilename, Title, Description,Keywords, and License to the first four columns. Filenameis required. Title, Description, Keywords, and License are optional.
3. Add your filenames to each row, under the first column named Filename. These must match exactly for your file to process efficiently. 
4. Next, add your desired  Title, Keywords, Description, and License in each row, corresponding to the correct filename. 
5. Save your file as a .csv

Column Name	Tips
Filename	A filename is required for every row Filenames should be in the first column Spaces are not recommended in the filename for metadata to process correctly. Filename extensions (i.e. .jpg, .mov, or .eps) should not be included if uploading via FTP. File extensions are optional if uploading via Add Data. Examples: Rock_Paper_Scissors_Flat_Icons, Abstract_Colored_Cubes_Background
Title	Titles are optional Titles should follow our Metadata Guidelines Examples: Rock Paper Scissors Flat Icons, Abstract Colored Cubes Background
Description	Descriptions are optional
Keywords	Keywords are optional Keywords should be separated by commas Keywords should follow our Metadata Guidelines Examples: abstract,icons,flat,rock,paper,scissors,background
License	License is optional License must be "pro", "free", "editorial", or left blank

Step 2: Upload your CSV file

You can upload a CSV with your source file(s) using FTP upload or after you upload your source file(s) from the Add Data page.

To upload a CSV with your source file(s) via FTP:

1. Go to https://contributors.vecteezy.com/portfolio/upload
2. Click on the FTP upload link
3. Upload our files and CSV at the same time by following our FTP Upload Process

Watch how to upload a CSV with your source files via FTP.

To upload a CSV after you upload your source file(s) via Add Data:

1. Go to https://contributors.vecteezy.com/portfolio/add_data
2. Click on "CSV"
3. Select "Upload CSV"
4. Select or drag and drop your CSV file
5. Wait for your file to upload
   1. If your file does not have the required column names or is not in the correct format, you will receive an error. Please ensure your file is prepared correctly before re-trying the upload.
6. Click "Done"
   1. Your metadata may take a few moments to process. You will see a message at the top of the screen when the processing is complete.
7. After your metadata is processed, refresh to see your updated metadata on the Add Data page

Watch how to upload a CSV via the Add Data page.