Problem · All agencies

“The agency rejects my CSV.” Why it happens and how to fix it

You uploaded your files, then the CSV, and the agency refused it or ignored it. Often the cause is a column name, a file name that does not match, or the file type.

Short answer

Check three things first: the column headers are the agency’s own, every file name in the CSV matches an uploaded file exactly (including the extension), and the file is a plain CSV. PhotoTager writes one CSV per agency with that agency’s columns and the file names of your uploads.

What the agencies say

WhatWhat the agency asks forSource
Adobe Stock: columnsRequired: Filename, Title, Keywords. Optional: Category, Releases. The headers must be exactly the ones in Adobe’s template.Adobe, “CSV requirements for Adobe Stock” (updated 11 Jun 2026)
Adobe Stock: file names and file typeFile names must match the uploaded files exactly, including the extension. CSV only, not .xls or .xlsx. At most 5,000 rows and 1 MB per file.Adobe, “CSV requirements for Adobe Stock”
Adobe Stock: titlePlain text, with no commas or special characters.Adobe, “CSV requirements for Adobe Stock”
Shutterstock: columnsFilename, Description, Keywords and Categories are required. Illustration, Mature Content and Editorial (Yes/No) are optional. Upload your files first, then the CSV with the CSV button on the Submit page.Shutterstock, “How do I include existing metadata with my content submission?” (updated 8 Sep 2026)

The usual causes

01 A column name that is not the agency’s A header that differs from the agency’s template, or a missing required column, is the first thing to check.
02 File names that do not match The name in the CSV has to match the uploaded file. A renamed file, or a missing or different extension, means no match.
03 The wrong file type Adobe Stock takes CSV only. A spreadsheet saved as .xlsx is not a CSV, so export it as CSV.
04 Accented letters shown as odd characters If letters like “ü” look wrong, the file was probably saved in a different encoding than the one your tool expects. Open the CSV in a text editor to see.
05 Uploading the CSV before the files Shutterstock wants the files uploaded first, then the CSV.

How PhotoTager avoids them

  1. 1
    One CSV per agency, with that agency’s columnsAdobe Stock, Shutterstock, iStock & Getty Images (ESP, qHero, DeepMeta) and Alamy each get their own file. Download the one for the agency you are uploading to.
  2. 2
    File names come from your uploadsThe file name column holds the name of the file you uploaded, so it matches your originals as long as you do not rename them.
  3. 3
    ESP files are written to match ESPESP CSVs are saved as CP1252 with Windows line endings, in the project export and in the batch export. Accented letters such as “ü” are kept, never turned into “?”. A character that CP1252 cannot hold is replaced by its plain letter.
  4. 4
    Alamy uses its Image RefPaste Alamy’s list of refs and file names into PhotoTager and the Alamy CSV carries the refs, matched by file name.
  5. 5
    Send it to yourselfYou can e-mail a project’s CSV files to any address, 10 sends per 24 hours.

What PhotoTager does not do for you

01 Shutterstock categories Shutterstock lists Categories as a required CSV column. PhotoTager leaves that column blank, so pick your categories when you submit.
02 Testing the CSV in the agency’s portal PhotoTager cannot see what an agency’s portal will accept. If an upload still fails, try one file first.

Get a CSV in the right format

Pick your agency and download a CSV with that agency’s columns. The free tools need no signup.

Questions

Can I upload an Excel file to Adobe Stock?

No. Adobe’s CSV requirements say CSV only, not .xls or .xlsx. Export the sheet as CSV first.

Why does the agency not find my files?

File names in the CSV have to match the uploaded files exactly, including the extension. PhotoTager takes them from the files you uploaded, so do not rename the originals afterwards.

Why does Shutterstock ask me for categories?

Categories is a required column in Shutterstock’s CSV. PhotoTager leaves it blank, so choose your categories when you submit.

Which CSV do I use for iStock & Getty Images?

The one made for your upload tool: ESP, qHero or DeepMeta. The ESP file is saved as CP1252 with Windows line endings.

Do accented letters survive?

Yes. Letters like “ü” are kept, never turned into “?”. In ESP files, a character that CP1252 cannot hold is replaced by its plain letter.