> For the complete documentation index, see [llms.txt](https://docs.ideogram.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ideogram.ai/using-ideogram/features-and-tools/batch-generation.md).

# Batch Generation

Batch Generation lets you create many generations from a spreadsheet of prompts and settings.

{% hint style="info" %}
Batch Generation is available where your plan and account support it, typically on Pro and Team plans.
{% endhint %}

Upload a .csv, .xls, .xlsx, or .ods spreadsheet up to 1 MB. A batch can include up to 500 prompt rows plus one header row. Each prompt row becomes one generation, and num\_images controls how many images each generation creates.

## How to Use Batch Generation

1. Open **Batch** from the [Navigation Bar](/using-ideogram/ui-overview/ui-components/navigation-bar.md) where available.
2. Download the simple or full template.
3. Fill in the spreadsheet using supported columns and values.
4. Upload the spreadsheet.
5. Review the preview, total generations, image count, and required Priority credits.
6. Start the batch.
7. Return to the Batch page to review progress, stop or resume supported jobs, and download completed results as a ZIP file.

Generated images are also available from your [Library](/using-ideogram/ui-overview/pages-ui/library-page.md) where your account and current product surface support them.

## Template Columns

The full template can include these columns:

| Column            | Purpose                                                          |
| ----------------- | ---------------------------------------------------------------- |
| `prompt`          | Text prompt for the generation.                                  |
| `visibility`      | Public/private visibility where private generation is supported. |
| `aspect_ratio`    | Aspect ratio such as `1:1` or `16:9`.                            |
| `magic_prompt`    | Magic Prompt setting.                                            |
| `model`           | Model label supported by the batch workflow.                     |
| `num_images`      | Number of images for each prompt row.                            |
| `seed_number`     | Seed value where supported.                                      |
| `rendering`       | Render speed where supported by the model.                       |
| `negative_prompt` | Terms or concepts to avoid where supported.                      |
| `style`           | Style setting where supported.                                   |
| `color_palette`   | Preset or custom color palette where supported.                  |

If a column has a default in the template or product flow, Ideogram applies that default when the cell is left blank.

## Formatting Tips

* Keep the header row exactly aligned with the template column names.
* Remove example rows before uploading your file.
* Save CSV files as UTF-8 when possible.
* In spreadsheet apps, format cells as text to prevent values such as `2:3` from being converted to dates.
* If upload validation fails, fix the highlighted rows or columns and upload again.

## Credits

Batch Generation uses Priority credits. Credit usage depends on the selected model, render speed, number of prompt rows, and `num_images` value.

For current plan and credit details, see [Available Plans](/plans-and-pricing/available-plans.md) and [ideogram.ai/pricing](https://ideogram.ai/pricing).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ideogram.ai/using-ideogram/features-and-tools/batch-generation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.