Typing titles and keywords one by one in the Contributor Portal is fine for five files, but exhausting for five hundred. Adobe Stock offers a much faster way: uploading metadata with a CSV file. One CSV can attach titles, keywords, categories and releases to thousands of assets at once. This guide covers the official rules and the mistakes that most often make CSV uploads fail.
What is CSV metadata?
A CSV (comma-separated values) file is a simple table you can create in Excel, Google Sheets or any spreadsheet app. Each row represents one file you've already uploaded to Adobe Stock, and each column holds one type of metadata.
File specifications
| Specification | Requirement |
|---|---|
| Format | CSV only (.csv); XLS/XLSX is rejected |
| Maximum rows | 5,000 per file |
| Maximum file size | 1 MB |
| Encoding | UTF-8 |
| Headers | Exactly as in the official template, not translated |
Start from the official sample file you can download in the Contributor Portal, so the headers are guaranteed to be right.
Required and optional columns
| Column | Limit | Content |
|---|---|---|
| Filename (required) | 30 characters | The exact file name including extension, e.g. beach01.jpg |
| Title (required) | 70 characters | A short description without commas or special characters |
| Keywords (required) | As set in the template | Comma-separated, ordered by importance |
| Category (optional) | A number | The number of the best-matching category |
| Releases (optional) | 30 characters | The exact file name of a release you've already uploaded |
The category column is optional, but Adobe strongly recommends filling it in. For writing good titles and keywords, see the Adobe Stock title and keyword rules.
How to upload a CSV
- Upload your asset files (photos, vectors, video) to the Contributor Portal as usual.
- Prepare the CSV from the official template; one row per file.
- Save it as CSV UTF-8.
- In the Contributor Portal, open Uploaded Files → New tab.
- Select Upload CSV, then Choose CSV file and upload.
- Spot-check a few files to confirm the metadata is attached, then submit for review.
Mistakes that make a CSV fail
- File names that don't match exactly. Even a small difference, such as upper versus lower case or a different extension, stops the metadata linking to the asset.
- Changed or translated headers. Headers must match the template exactly.
- Saving as XLSX. Adobe only accepts .csv.
- The wrong encoding. If you use Excel outside the US, save as CSV UTF-8. If that option isn't available, open the file in Notepad and re-save it as UTF-8.
- Commas in titles. Titles can't contain commas, because commas separate the columns.
- More than 5,000 rows or more than 1 MB. Split it into several files.
- Releases not uploaded yet. Release names in the CSV must point to releases already in the portal. If several releases share a name, the system uses the most recent.
Workflow tips
- Give files descriptive, consistent names from the camera or export onwards. Short names under 30 characters make the CSV easier.
- Create a template per series. Similar files can share base keywords, but still adapt the title and some keywords per file. Adobe's similar-content guidance says identical metadata on near-identical files can be refused.
- Keep your CSVs as an archive. They're useful if you want to upload the same work to other agencies with adjustments.
For vectors, there are extra notes on file formats in how to upload vectors to Adobe Stock.
Sources
StockSells is an independent product and is not affiliated with Adobe. Adobe and Adobe Stock are trademarks of Adobe Inc.
StockSells
Know what sells before you make it.
Real downloads, sales speed, golden keywords and a content brief in one search.