Distribución

Adobe Stock CSV Upload Guide: Format, Keywords and Common Errors

Learn Adobe Stock CSV requirements, exact filename matching, columns, keyword limits and how to import metadata without common formatting errors.

MS Microstock Studio · 6 min read · 2026-10-08

Production photography and editorial workflow Open laptop and notebook on wooden office desk illustrating stock metadata CSV preparation

Key takeaway

To add metadata to multiple Adobe Stock assets, upload image files first and match exact filenames in a CSV with headers Filename, Title, and Keywords. Adobe enforces a 30-character filename limit and 50-keyword cap. Importing metadata does not equal final moderation or acceptance.

In this guide

Why use a CSV for stock metadata?

Entering a title and keywords for one photo is manageable. Repeating the process across dozens of assets invites copy-and-paste errors, inconsistent naming, and missing metadata. A CSV—comma-separated values—stores one asset's filename and metadata in each row so a contributor can prepare and review a batch before importing it.

The CSV is not a replacement for the image files. You upload the assets and then associate metadata with them using the contributor portal. Adobe also distinguishes three events: uploading a file, submitting it for moderation, and receiving a review decision. Avoid treating a successful metadata import as evidence of publication or acceptance.

Adobe Stock CSV field requirements

The requirements below come from Adobe's published CSV documentation, last checked October 8, 2026.

The CSV must be 1 MB or less, with no more than 5,000 rows. Use the current official Adobe template as the definitive authority for the exact column header row and supported options. Do not translate header names. Adobe recommends CSV UTF-8 when exporting from Excel outside the United States. Requirements · Creation steps.

Field	Required?	Published requirement
`Filename`	Yes	Exact uploaded filename including extension; 30 characters max
`Title`	Yes	Plain text title; 70 characters max; avoid commas and special characters
`Keywords`	Yes	Comma-separated list ordered by relevance; 50 keywords max
`Category`	Optional	Numeric Adobe category, where supported by the template
`Releases`	Optional	Exact release filename, subject to its documented limit

Worked example: two images, two metadata rows

This is a synthetic editorial dataset. The filenames are intentionally short and the titles avoid commas. The first ten terms describe each illustrated scene, but you must substitute descriptions appropriate to your own files.

These two rows are illustrative editorial examples to demonstrate column formatting; no public CSV is offered, and the examples do not constitute a real import test in Adobe Contributor. The image illustrations in this guide are demonstration assets only and are not asserted to be Adobe-approved stock photographs.

Filename	Title	Example first keywords
`coffee_desk_01.jpg`	White ceramic coffee cup beside open notebook on wooden desk	coffee, cup, notebook, wooden desk, ceramic mug
`laptop_desk_02.jpg`	Open laptop and notebook on wooden office desk	laptop, notebook, desk, computer, office

Why double-check every filename?

coffee_desk_01.jpg and coffee_desk_1.jpg are different values. So are differently capitalized names. Adobe requires exact matching of uploaded asset filenames and the corresponding CSV rows. If your export process renames files, regenerate or reconcile the CSV before uploading it.

How to prepare and upload a CSV

Follow these verified operational steps to prepare and import metadata without errors:

Adobe's current contributor instructions describe the Uploaded Files → New → Upload CSV path. Interface labels may change; use the official upload instructions if the portal looks different.

Finalize the source images. Check image dimensions, file format, rights, disclosure requirements, and actual filenames.
Download Adobe's current CSV template. Use its required headers exactly as provided.
Populate one row per image. Keep descriptive titles, relevant keywords, and exact filename matches. Use correct quoting for comma-separated keyword values.
Export as CSV UTF-8. Open the saved file with a text editor or CSV reader to verify its columns and character encoding.
Upload your content to Adobe Stock Contributor. Confirm that the relevant images appear under Uploaded Files.
Go to the New tab and choose Upload CSV. Select the file, complete the import and refresh to see the applied changes.
Inspect the result before submission. Verify titles, keyword order, image association, releases and any AI disclosure fields; then complete the submission workflow.

Common CSV problems and how to diagnose them

Metadata did not appear on the intended image. Check filename capitalization, extension, spaces, and any renaming performed during export or upload.

Columns shifted after export. Use a standard CSV library or Adobe's spreadsheet template. Keyword lists containing commas must stay inside a single CSV field; broken quotation marks can move values into the wrong columns.

Adobe rejects the file format. Confirm it is .csv, not .xlsx, and that the file meets the published size and row limits. For international spreadsheets, use UTF-8.

A title is truncated or rejected. Recheck the maximum length and remove unnecessary punctuation. Adobe's CSV rules are more specific than simply writing a sentence that reads well.

The assets still need attention. Metadata import does not bypass the contributor portal's moderation, release, copyright, technical or AI-labeling requirements.

What about Microstock Studio exports?

Microstock Studio offers AI-assisted title and keyword preparation and export features. Do not assume an exported package has been certified by Adobe until its delivery files and CSV have been validated against the agency's current rules. The Adobe filename-length and file-format requirements remain part of our pre-beta compatibility work.

If you prepare AI-generated content, also consult Adobe Stock AI Image Requirements for technical quality, resolution, and disclosure checks. If your metadata still needs editing, begin with our keyword guide.

Frequently asked questions

Direct, authoritative answers to the most common questions about Adobe Stock CSV preparation, column limits, and upload workflows.

What columns does an Adobe Stock CSV need?

Adobe documents three required fields: Filename, Title, and Keywords. Additional fields, such as Category and Releases, are optional in its requirements. Copy the exact header row from the current Adobe template before submitting.

What is the maximum Adobe Stock CSV filename length?

Adobe specifies 30 characters maximum in the Filename field, including the file extension. The value also must match the uploaded asset exactly. Long generated export names can cause compatibility problems.

How many rows can an Adobe Stock CSV have?

Adobe documents a maximum of 5,000 rows and a file-size limit of 1 MB. A batch can encounter either limit first, depending on how much metadata its rows contain.

Why isn't my Adobe Stock CSV working?

Frequent causes include mismatched filenames, changed headers, invalid quoting, incorrectly encoded characters, overlong titles, or files over the CSV limits. Compare the file with Adobe's template and validate individual records before retrying.

Does uploading a CSV submit photos for review?

No. The CSV applies metadata to uploaded assets. The contributor still needs to review the fields, provide required releases or AI disclosures, and complete the separate submission steps.

Can I use a CSV to upload photos to multiple stock agencies?

A CSV is agency-specific. Do not assume that an Adobe-formatted file meets another agency's field, category, keyword-order, naming, or disclosure requirements. Validate each destination independently.