qHero CSV columns
| Column | What the CSV puts in it |
|---|---|
file name | Your photo's file name. Rows are matched to files by it, so keep the names you upload. |
title | The title. |
description | The description. For editorial, it starts with the place and the date. |
keywords | Up to 50, matched to the iStock vocabulary and in its spelling. |
How to import it in qHero
- Add your photos in qHero.
- Import the CSV. Rows are matched to your files by file name.
- Review the keywords and submit to iStock.
What the iStock & Getty Images checker looks at
Controlled vocabulary
Every keyword is matched to about 20,600 iStock vocabulary terms. Keywords that are not in it are marked, because iStock does not use them as written.
Phrases
A phrase that is not a vocabulary term is split into the terms inside it: "white electric car" gives "White Color" and "Electric Car".
iStock spelling
Matched keywords are shown and exported in iStock's own spelling, so "sofas" becomes "Sofa" and "grey" becomes "Gray Color".
Similar keywords
Up to 25 related vocabulary terms you can add with one click.
50 keywords
iStock and Getty Images allow up to 50 keywords per file.
Last checked: . Agencies update their rules, so confirm against the official guidelines.
Every agency's rules the checker uses
| Agency | Rule | What the checker does |
|---|---|---|
| iStock & Getty Images | Up to 50 keywords from the controlled vocabulary | Matches every keyword to the iStock vocabulary of about 20,600 terms, shows what iStock will not accept and suggests similar vocabulary keywords. |
| Adobe Stock | Up to 49 keywords; the first 10 weigh most | Counts your keywords and marks the first 10. |
| Adobe Stock | Title up to 200 characters, about 70 recommended | Flags titles over the limit and warns above the recommended length. |
| Adobe Stock | No repeated, plural or US/UK spelling pairs; no artist names | Finds repeats, singular/plural and spelling pairs, and copyrighted artist names. |
| Shutterstock | 7 to 50 keywords | Counts your keywords against both limits. |
| Shutterstock | Description of at least 5 words and up to 150 characters | Checks word count and length, and flags titles that read like a keyword list. |
| Alamy | A caption and at least 5 tags to go on sale, up to 50 tags | Counts your tags; the Alamy CSV puts your first 10 in the Supertags column. |
| Alamy | Captions are cut at 150 characters in Image Manager | Warns when the title is longer. |
| All agencies | No brand, product or character names in commercial metadata | Flags common brand, product and character names. |
All limits side by side: stock agency metadata requirements compared.
How it works
- Drop up to 20 photos, the exported JPEGs you are about to upload, or paste a title and keywords.
- Read the checks. Each agency gets a verdict, with every problem listed. The first 10 keywords are marked for Adobe Stock, and keywords iStock won't accept are crossed out.
- Fix them here. Remove a keyword with ×, add new ones, take similar iStock terms with one click, or edit the title. Every check runs again as you go.
- Download a CSV for Adobe Stock, Shutterstock, iStock or Alamy and upload it with your photos, or copy the keywords.
Checkers for each agency
Adobe Stock metadata checker
That agency's rules first, with its CSV.
Shutterstock metadata checker
That agency's rules first, with its CSV.
Alamy metadata checker
That agency's rules first, with its CSV.
iStock keyword checker for ESP
The same check, with the ESP CSV first.
iStock keyword checker for DeepMeta
The same check, with the DeepMeta CSV first.
Free iStock Keyword Generator for qHero
No keywords yet? Write them from the photo with AI.
Stock rejection checker
Logos, people, property and quality problems in the photo itself.
Selling on another agency?
The checker covers Adobe Stock, Shutterstock, iStock & Getty Images and Alamy. Tell us which agency you'd like next; we add the ones contributors ask for most.
Frequently asked questions
Which CSV columns does qHero use?
file name, title, description and keywords.
Are the keywords iStock keywords?
Yes. The qHero CSV uses the keywords matched to the iStock vocabulary, in iStock's spelling, up to 50 per file.
Why does iStock drop some of my keywords?
iStock and Getty Images only use keywords from their controlled vocabulary. A keyword that is not in it, or a phrase the vocabulary does not have, is not used. The checker shows which ones those are.
Is this the same as disambiguation in ESP?
No. ESP asks you to pick the meaning of words with several senses while you submit. The checker finds the vocabulary term for each keyword; confirm the meaning in ESP when it asks.
Can I get iStock keywords written for me?
Yes. The free iStock keyword generator writes them from your photo, and in the PhotoTager app a model trained on the iStock vocabulary writes them for every photo you process.
Is the metadata checker free?
Yes, free and unlimited, with no account. The checks run in your browser. For the iStock check, only the keywords and title are sent to PhotoTager, never the photo.
Which metadata fields does it read?
The XMP title, headline, description, keywords and copyright (dc:title, photoshop:Headline, dc:description, dc:subject, dc:rights) and, in JPEG files, the IPTC Object Name, Headline, Caption, Keywords and Copyright Notice. These are the fields Lightroom, Bridge, Photoshop and most keywording tools write and that stock agencies read on upload.
Can I fix the metadata here?
Yes. Edit the title, remove keywords or add new ones, and every check runs again as you type. Then copy the keywords or download a CSV for Adobe Stock, Shutterstock, iStock or Alamy with one row per photo. The CSV fills in the metadata when you upload it with your photos; the photo files themselves are not changed.
How does the iStock check work?
iStock and Getty Images only use keywords from their controlled vocabulary. The checker matches each of your keywords to about 20,600 iStock vocabulary terms, shows the ones iStock will not accept as written, and suggests similar vocabulary keywords you can add with one click. The iStock CSV uses the matched keywords in iStock's spelling.
Why does the checker find no keywords in my file?
Either the file has no embedded metadata, or your editor saved it to a separate .xmp sidecar file (common for RAW files in Lightroom). Export a JPEG with metadata included and check that file instead.
Which file types are supported?
JPEG, PNG and WebP. IPTC fields are read from JPEG only; for the other formats the checker reads XMP.
What does "your description must be at least 5 words" mean on Shutterstock?
Shutterstock asks for a complete descriptive sentence of at least five words, and its description field also works as the title. The checker flags any title shorter than that. Rewrite it as a sentence that says what the subject is doing and where, rather than adding filler words.
Does it check the photo itself?
No, only the metadata. Logos, recognizable people, property and image quality are checked by the free stock rejection checker, which looks at the photo with AI.
Metadata that passes, for a whole shoot
PhotoTager writes titles and keywords for every photo you process, inside each agency's limits, with iStock keywords from its vocabulary. Pay-as-you-go from $0.04 per image, credits never expire.
Start free with $2 of creditsMore free tools: Description generator · Editorial caption generator · Stock rejection checker · Keyword generators