How to import a CSV

There are two CSV-import flows, and they do different things:

• Generate alt text from a CSV — start from Create and click Import CSV. Each row becomes an image card; click Generate for all to run the AI on every row. This does consume credits.
• Import existing alt text into My Library — start from My Library, click Import CSV, and choose Import existing alt text. Rows are added to your library with whatever alt text was in the alt_text_xx columns; no AI runs and no credits are consumed. Useful for bringing in a back catalog you already wrote.

If you click Import CSV & generate alt text from the My Library import modal, it sends you to the Create page (/create?csv=true) to use the generate flow above.

Download CSV template or open Google Sheets template. Either has all supported column headers pre-filled.

You only need image_url. Everything else is optional and falls back to your Generation Defaults if missing.

Mirrors the column list shown in the Import CSV modal:

Required

• image_url — image URL to process

Optional

• image_name — identifier or SKU
• alt_text_xx — pre-existing alt text per language using ISO 639 codes (alt_text_en for English, alt_text_fr for French, alt_text_zh_CN for Chinese Simplified, alt_text_pt_BR for Brazilian Portuguese)

E-commerce

• brand — brand name
• product — product name
• primary_color — product color

SEO Keywords (max 10 each, separated with | or , — e.g. wireless|noise-cancelling|over-ear or wireless,noise-cancelling,over-ear)

• seo_keywords
• negative_keywords

Advanced

• custom_prompt — custom instructions
• text_length — Normal or Detailed

Switching from another tool? The importer also accepts these legacy aliases: asset_id (→ image_name), ecomm_brand (→ brand), ecomm_product (→ product), ecomm_color (→ primary_color), keywords (→ seo_keywords), and gpt_prompt (→ custom_prompt).

If all you have is a list of URLs, that's enough. Empty cells anywhere else are fine — Alt Text Studio falls back to your Generation Defaults for anything missing.

When you already have alt text written, put it in alt_text_en (or alt_text_xx for other languages). Pair this with the Import existing alt text flow on My Library to skip generation entirely. Empty alt_text_xx cells just mean that row will be generated by the AI normally.

Mix and match: e-commerce details for product photos, custom prompts for tone, longer text length for hero shots. Leave any cell blank to fall back to your defaults.

Back on Create, drop the .csv onto the Import CSV zone (or click to pick it). Each row becomes a card in the batch with preview, options, and the seeded alt text where applicable. You can still tweak per-image options before clicking Generate for all.

UTF-8 encoding. The seo_keywords and negative_keywords columns accept either pipe (|) or comma (,) as the separator.