How to Upload Your Metadata to Stock Agencies
- Three ways inA separate CSV, keyworded files, or the metadata written into the originals.
- Same metadata, three carriersAll three methods carry the same title, description and keywords.
- Agency by agencyExact steps for Adobe Stock, Shutterstock, iStock, Pond5 and Depositphotos.
You have a title, a description and a full set of keywords for every file. The agency doesn't have them yet. This guide covers the three ways to get them there and which one suits the way you upload, followed by the exact steps for Adobe Stock, Shutterstock, iStock, Pond5 and Depositphotos.
All three methods carry the same metadata. What changes is whether it travels in a separate file (a CSV) or inside the photo or video itself.
The three methods at a glance
Agency CSV
A spreadsheet in each agency's own format. You upload your files as usual, then import the CSV and every field fills in. Steps →
Keyworded files
A ZIP of your files with the metadata already written inside them. Upload those, and agencies that read embedded metadata fill the fields themselves. Steps →
Into your originals
A double-click script that writes the metadata into the files on your own disk. Good for FTP uploads and very large files. Steps →
| Method | You download | Pick it when |
|---|---|---|
| Agency CSV | One .csv per agency | You upload through the agency's website, you send to iStock, or you want each agency's exact limits applied for you |
| Keyworded files | A ZIP of your JPEGs or MP4/MOV clips with the metadata inside | You want one set of files you can drop into any agency that reads embedded metadata |
| Into your originals | A small script plus a metadata file for ExifTool | You upload by FTP, or your files are too large to want a second copy |
Method 1: agency CSV
A CSV is a plain spreadsheet with one row per file. Each agency expects different columns, a different keyword cap and a different title length, so PixelKeyAI builds a separate file for each one. You don't need to edit it.
- Download the CSV. Under your results, open Export CSV ▾ and pick the agency. If you keyworded with Multi-Agency mode on, ⬇ Both CSVs downloads the agency file and the iStock file together.
- Upload your files to the agency first. Use its website or FTP, and upload the same files you keyworded, under the same names. The agency matches each row to a file by its exact filename, including the extension and capitalization.
- Import the CSV in the agency's upload area. Where that lives is covered for each agency below.
- Spot-check and submit. Open two or three files to confirm the title and keywords arrived, fill in anything the agency still asks for (categories, releases), then submit for review.
Method 2: keyworded files
Click 📦 Download Keyworded Files under your results. You get a ZIP of your original, full-resolution files with the title, description and keywords written into the standard metadata fields that agencies and photo software read (IPTC and XMP for photos; the MP4/MOV metadata atoms for video). Nothing is re-compressed, and nothing is uploaded: the writing happens in your browser.
- Unzip the download.
- Upload those files to the agency the way you normally would.
- The agency reads the metadata on upload. Check a file or two, then submit.
Two things to know:
- Photos are written as JPEG; videos as MP4 or MOV. Other image formats are included in the ZIP unchanged, so convert them to JPEG before keywording if you want metadata inside.
- Your original files are only kept for the session that keyworded them. If you reload the page, add the same files again before downloading, or use the CSV instead. Every card also has its own ⬇ Embed button for a single file.
Method 3: write it into your originals
The One-Click Embed buttons (Windows or Mac) download a small package for ExifTool, the free tool photographers have used for metadata for decades. It writes the metadata into the files already on your disk, so you never handle a second copy.
- Download the package for your system and unzip it into a new folder.
- Install ExifTool once. On Windows, put
exiftool.exein the same folder; on a Mac, run the installer from exiftool.org. The includedREADME.txtwalks through it. - Copy the files you keyworded into that folder.
- Double-click
run.bat(Windows) orrun.command(Mac). Each file gets its title, description and keywords. ExifTool keeps a backup of every original until you delete it. - Upload the files by FTP or through the agency's website.
If you keyword inside Lightroom Classic, there's a fourth route: the free Lightroom plugin writes titles, captions and keywords straight into your catalog, and they travel with every JPEG you export from Lightroom.
Agency by agency
Agencies change their contributor portals from time to time. If a button has moved, look for the CSV or metadata import option on the page where your uploaded files are waiting for submission.
Adobe Stock
- CSV: upload your files in the Contributor Portal first. Then open the New tab under Uploaded Files, choose Upload CSV, select the file, and refresh once Adobe confirms the data was applied.
- Keyworded files: Adobe keeps titles and keywords already embedded in a file, so uploading the keyworded JPEGs works without a CSV.
- What the Adobe CSV contains: Filename, Title, Keywords, Category and Releases, with up to 49 keywords. Adobe has no separate description field, so the Title column carries your title, the same one your keyworded files give Adobe.
- Adobe gives the first keywords the most weight. PixelKeyAI lists the strongest ones first, so keep that order if you edit.
- Limits, the exact CSV columns and common mistakes: Adobe Stock metadata requirements.
Shutterstock
- CSV: upload every file in the submission first, through the website or FTPS. Then go to the Submit page and click the CSV button at the top. Don't send the CSV through FTPS along with the files.
- Every row has to match a file in the current submission. If you're submitting only part of a batch, delete the other rows first, or download a CSV of just the files you're sending.
- What the Shutterstock CSV contains: Filename, Description, Keywords, Categories and the Editorial, Mature content and Illustration flags, with up to 50 keywords. Shutterstock has no title field; the description is the one text column.
- Keyworded files also work: Shutterstock can pick up metadata already embedded in your JPEGs.
- Limits, the exact CSV columns and common mistakes: Shutterstock metadata requirements.
iStock
- iStock files go up through Getty's ESP contributor tool, in batches. Upload your files to a batch, then use ESP's CSV import to apply the iStock CSV.
- iStock only accepts keywords it recognises, so use the iStock CSV rather than a generic one. With iStock Precision on, the keywords are terms iStock's search actually indexes, and the iStock CSV carries that set.
- What the iStock CSV contains: iStock's own columns (file name, created date, title, description, country, brief code, keywords, releases), with up to 50 keywords.
- ESP asks you to confirm any keyword it can't match on its own. Review those before you submit the batch.
- Limits, the exact CSV columns and common mistakes: iStock metadata requirements.
Pond5
- CSV: upload your files from the dashboard or by FTP and let them finish processing. Then go to Uploads, open Apply CSV, choose the media type and upload the Pond5 CSV.
- What the Pond5 CSV contains: Filename, Title, Description, Keywords, Category and ClipType, with up to 50 keywords.
- Pond5 is strongest for video, and the same steps cover clips. Set your prices and usage types in Pond5 before submitting.
- Limits, the exact CSV columns and common mistakes: Pond5 metadata requirements.
Depositphotos
- Keyworded files are the simplest route: upload them and check that the title, description and keywords came through before you submit.
- If you'd rather use a CSV, the Depositphotos CSV (Filename, Title, Description, Keywords, up to 50 keywords) is in the export menu. Upload the files first, then apply it from your contributor upload area.
- Limits, the exact CSV columns and common mistakes: Depositphotos metadata requirements.
Videos
Everything above applies to clips too. The agency CSVs have video rows, the keyworded-files download writes into MP4 and MOV clips in your browser without uploading them, and the One-Click Embed script handles video as well. Clips in other containers (MKV, AVI, WebM) can't hold this metadata, so use the CSV for those.
Mistakes that stop metadata from showing up
- Renaming files between keywording and uploading. The CSV no longer matches anything, and most agencies don't tell you.
- Uploading the CSV before the files. The agency has nothing to attach it to yet.
- Using one agency's CSV for another. The columns differ, so the import is rejected or lands in the wrong fields.
- Re-saving the CSV in Excel. Excel can change the encoding and the quoting. If you must edit it, save it as "CSV UTF-8".
- Uploading a CSV and keyworded files to the same agency. It's harmless, but it's double the work. One method per agency is enough.
Frequently asked questions
Do I need a CSV if I upload keyworded files?
No. Pick one method per agency. Keyworded files already carry the title, description and keywords inside them, so the agency fills its fields from the file. A CSV is the alternative when you upload files that have no metadata in them.
Why didn't my CSV apply to my files?
Almost always a filename mismatch. The agency matches each CSV row to an uploaded file by its exact name, including the extension and capitalization, so IMG_0412.JPG and IMG_0412.jpg are different files. Upload the files under the same names you keyworded them with, and upload them before the CSV.
Can I download the CSV again later?
Yes. Every batch stays in the Insights tab, and you can export it again from there. Downloading a CSV or a ZIP never costs credits.
Which method should I use for iStock?
Use the iStock CSV. iStock only accepts keywords it recognises, so its CSV carries the iStock set when you keyworded with iStock Precision on, and its own column layout for Getty's ESP upload tool.
Does this work for videos?
Yes. The same agency CSVs cover video, and the keyworded-files download writes metadata into MP4 and MOV clips directly in your browser, without uploading them.
Related guides
The IPTC metadata fields glossary explains every field name used here. Before you upload, the stock photography workflow guide covers shooting, editing and submission end to end, and stock photo keywords by niche shows what buyers search for in each category.