# Source: https://docs.ideogram.ai/using-ideogram/features-and-tools/batch-generation.md

# Batch Generation

Create multiple images at once with Batch Generation. Upload a spreadsheet that contains your prompts and settings, then return later to find all your generated images ready.

{% hint style="info" %}
**Note:** Batch Generation is available only with the **Pro Plan** and **Team Plan**.
{% endhint %}

## Using Batch Generation

Follow these steps to generate images in bulk:

1. Select the **Batch** icon <picture><source srcset="https://1799634369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzjhNby3LLsIikYuvxAJP%2Fuploads%2FMP8QEqQZ3XWlVM5BFZXj%2FBatch%20-%20Dark%2020px.svg?alt=media&#x26;token=ea6cf9eb-9e66-492f-8a28-9b222a226b46" media="(prefers-color-scheme: dark)"><img src="https://1799634369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzjhNby3LLsIikYuvxAJP%2Fuploads%2FcANgCWqkv8mkNrmznSWu%2FBatch%20-%20Light%2020px.svg?alt=media&#x26;token=31807bee-0c9f-4531-8b4b-5ace78d3f3f7" alt="" data-size="original"></picture> in the [Navigation Bar](https://docs.ideogram.ai/using-ideogram/ui-overview/ui-components/navigation-bar).
2. Select **Download template** to get a sample spreadsheet.
   * To access the complete version, open the dropdown and choose **Full template**.

<div align="center"><figure><picture><source srcset="https://docs.ideogram.ai/~gitbook/image?url=https%3A%2F%2F1799634369-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FzjhNby3LLsIikYuvxAJP%252Fuploads%252FlK3k11vH9WKhClICZW6k%252FBatch%2520Generation%2520%25E2%2580%2593%2520Ideogram%2520-%2520Light%2520Dark%25402x.png%3Falt%3Dmedia%26token%3De07a481d-4785-4caf-a765-1c09358036ff&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=f1dd58fa&#x26;sv=2" media="(prefers-color-scheme: dark)"><img src="https://docs.ideogram.ai/~gitbook/image?url=https%3A%2F%2F1799634369-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FzjhNby3LLsIikYuvxAJP%252Fuploads%252Fb8v1HkvMQSBQGiOsB0Xh%252FBatch%2520Generation%2520%25E2%2580%2593%2520Ideogram%2520-%2520Light%2520Dark%25402x.png%3Falt%3Dmedia%26token%3D111f4986-5c2c-4ba6-991b-31068432afed&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=d6564a2a&#x26;sv=2" alt="Batch Generation interface showing upload and status areas"></picture><figcaption><p><em>Batch Generation interface showing upload and status areas.</em></p></figcaption></figure></div>

3. Fill out the spreadsheet using the expected values for each column.
   * Remove the example rows before editing.

{% hint style="warning" %}
**Warning:** Each uploaded file has a limit of <mark style="color:red;">**500 rows**</mark>, including the header row.
{% endhint %}

4. Save the file as `CSV UTF-8 (comma-delimited)` to prevent encoding issues.
5. Select **Upload spreadsheet** on the Batch Generation page.
   * Accepted formats: `.csv`, `.xls`, `.xlsx`.
6. If any errors appear, fix them in your file and upload it again.

<figure><picture><source srcset="https://1799634369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzjhNby3LLsIikYuvxAJP%2Fuploads%2FhbzQh9gdZ52dwLIEsAPn%2FBatch%20Generation%20%E2%80%93%20Ideogram%20-%20Light%20Dark%402x.png?alt=media&#x26;token=c67f33cc-8739-4713-8540-ec89327d49d1" media="(prefers-color-scheme: dark)"><img src="https://1799634369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzjhNby3LLsIikYuvxAJP%2Fuploads%2FUyxzqac0qX3ElKoPrPnM%2FBatch%20Generation%20%E2%80%93%20Ideogram%20-%20Light%20Dark%402x.png?alt=media&#x26;token=592b07bd-92ad-481e-bc2f-2276e6b25cf9" alt=""></picture><figcaption><p>Example of an error message during file upload.</p></figcaption></figure>

7. When your file uploads successfully, review the Batch Generation details section. You’ll see:
   * A preview of the first row
   * The total number of rows and images
   * The **Priority Credits** required and available\
     If needed, select **Replace** (top-right) to upload a different file.

<figure><picture><source srcset="https://1799634369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzjhNby3LLsIikYuvxAJP%2Fuploads%2FJ5zOtLwBpQk4DQFEtNYH%2FBatch%20Generation%20%E2%80%93%20Ideogram%20-%20Light%20Dark%402x.png?alt=media&#x26;token=78a679c8-1e1f-4573-b13d-f4b944a5abee" media="(prefers-color-scheme: dark)"><img src="https://1799634369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzjhNby3LLsIikYuvxAJP%2Fuploads%2F7XqGFiDZ3Mjm7ARnrlQp%2FBatch%20Generation%20%E2%80%93%20Ideogram%20-%20Light%20Dark%402x.png?alt=media&#x26;token=a622d293-631b-4cc4-858c-1f6a46f6d01d" alt=""></picture><figcaption><p>Batch Generation interface showing uploaded file details and Replace option.</p></figcaption></figure>

8. Select **Start batch generation** to begin. A progress list shows the batch status. You can continue using Ideogram while the generation runs.
9. When processing completes, you’ll receive a notification confirming that the batch is complete.

<figure><picture><source srcset="https://1799634369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzjhNby3LLsIikYuvxAJP%2Fuploads%2FzJtUChe2gqK8LyTCx1pl%2FBatch%20Generation%20%E2%80%93%20Ideogram%20-%20Light%20Dark%402x.png?alt=media&#x26;token=e6a14456-bec1-4628-a7be-c6c81f3cb100" media="(prefers-color-scheme: dark)"><img src="https://1799634369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzjhNby3LLsIikYuvxAJP%2Fuploads%2FlHSEVKAAxuKHU0RRVCLC%2FBatch%20Generation%20%E2%80%93%20Ideogram%20-%20Light%20Dark%402x.png?alt=media&#x26;token=464523ed-5370-40b5-a8e5-2fa00a2ed89a" alt="" width="563"></picture><figcaption><p>Notification shown when Batch Generation completes successfully.</p></figcaption></figure>

{% hint style="info" %}
To stop a running batch, select the **Stop** icon at the end of the status row.\
Later, select **Resume** to continue or **Download** to save all images as a compressed **ZIP** file.
{% endhint %}

<figure><picture><source srcset="https://1799634369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzjhNby3LLsIikYuvxAJP%2Fuploads%2FWg9RUVWmoRxhVebEVPRA%2FBatch%20%E2%80%93%20Stop%20-%20Dark%402x.webp?alt=media&#x26;token=0d138f8a-4f79-46a6-99e4-f0d6db541206" media="(prefers-color-scheme: dark)"><img src="https://1799634369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzjhNby3LLsIikYuvxAJP%2Fuploads%2FIWdp1vT5DT9m1kNvO2mv%2FBatch%20%E2%80%93%20Stop%20-%20Light%402x.webp?alt=media&#x26;token=a54d5020-314a-4834-8967-ba27cfe2fa0c" alt=""></picture><figcaption></figcaption></figure>

11. When the process completes, select the **Download** icon at the right end of the status row to get all images as a **ZIP** file.

Alternatively, you can view all generated images in the **Creations** page.

<figure><picture><source srcset="https://1799634369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzjhNby3LLsIikYuvxAJP%2Fuploads%2FtGg61yIKYADOEZY6ukt0%2FBatch%20Generation%20%E2%80%93%20Ideogram%20-%20Light%20Dark%402x.png?alt=media&#x26;token=33e85c08-dced-4676-b29c-1e10d1d1d94e" media="(prefers-color-scheme: dark)"><img src="https://1799634369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzjhNby3LLsIikYuvxAJP%2Fuploads%2FFjxwbN9lGrrBZWYQpAD5%2FBatch%20Generation%20%E2%80%93%20Ideogram%20-%20Light%20Dark%402x.png?alt=media&#x26;token=430ba5f5-4679-420a-a4df-7960d59fee84" alt=""></picture><figcaption><p>The <strong>Download</strong> icon is located at the right end of the status row.</p></figcaption></figure>

## Expected Values

The table below lists all recognized column names, valid inputs, and default settings for Batch Generation.

<table><thead><tr><th width="150.58203125">Column</th><th width="463.984375">Valid values</th><th>Default</th></tr></thead><tbody><tr><td><code>prompt</code></td><td>Any text  <mark style="color:red;">*</mark><em><mark style="color:red;">Required</mark></em></td><td>—</td></tr><tr><td><code>visibility</code></td><td><code>public</code>, <code>private</code>  <mark style="color:red;">*</mark><em><mark style="color:red;">Required</mark></em></td><td>—</td></tr><tr><td><code>aspect_ratio</code></td><td>Predefined aspect ratio, (e.g., <code>16:9</code>). See <a href="../../generation-settings/aspect-ratio-and-dimensions#defaults-aspect-ratios-and-sizes">Aspect Ratios</a></td><td><code>1:1</code></td></tr><tr><td><code>magic_prompt</code></td><td><code>on</code>, <code>off</code></td><td><code>on</code></td></tr><tr><td><code>model</code></td><td><code>3.0</code>, <code>2.0</code>, <code>2a</code>, <code>1.0</code></td><td><code>2.0</code></td></tr><tr><td><code>num_images</code></td><td>Any whole number from <code>1</code> to <code>4</code></td><td><code>4</code></td></tr><tr><td><code>seed_number</code></td><td>Any whole number from <code>0</code> to <code>2147483647</code></td><td>—</td></tr><tr><td><code>rendering</code></td><td><code>default</code>, <code>turbo</code>, <code>quality</code></td><td><code>default</code></td></tr><tr><td><code>negative_prompt</code></td><td>Any keywords separated by commas</td><td>—</td></tr><tr><td><code>style</code></td><td><p>3.0: <code>auto</code>, <code>general</code>, <code>realistic</code>, <code>design</code> </p><p>2.0: <code>auto</code>, <code>general</code>, <code>realistic</code>, <code>design</code>, <code>3d</code>, <code>anime</code>    <br><br><br>1.0: <em>Same as 2.0. Use v1.0 keywords in the prompt.</em></p></td><td><code>auto</code></td></tr><tr><td><code>color_palette</code></td><td><p>Up to five (5) hexadecimal RGB values separated with spaces. Ex.: <code>#CBA324 #F86C14 #C71E71</code></p><p></p><p>or any preset <a href="../generation-settings/color-palette">Color palette</a> name:<br><code>ember</code>, <code>fresh</code>, <code>jungle</code>, <code>magic</code>, <code>melon</code>, <code>mosaic</code>, <code>pastel</code>, <code>ultramarine</code></p><p></p><p>Only available in <strong>Model 2.0</strong> or later.</p></td><td>—</td></tr></tbody></table>

If a column includes a defined default, that value is applied automatically when no entry is provided.

{% hint style="info" %}

## Formatting Tips

* Re-save your file as `CSV UTF-8 (comma-delimited)` if a **“Sorry, something went wrong”** error appears.
* Ensure all column headers match the template exactly (case-sensitive).
* The order of columns is flexible.
* In Excel, format cells **as Text** to avoid unwanted conversions (e.g., `2:3` → date).
  {% endhint %}

## Combining *Batch Generation* with Other AI Tools

You can pair Batch Generation with external tools like ChatGPT to automatically fill your CSV with creative prompts.

**Example workflow:**

1. Download the CSV template from the Batch Generation page.
2. Provide that template to ChatGPT and ask it to fill a CSV file following the same structure.
3. Include instructions such as:
   * Design goal
   * Example prompts that worked well for you
   * Desired settings (*aspect ratio*, *visibility*, *model*, *style*, *rendering*)
4. Upload the ChatGPT-generated CSV file to Ideogram to create all images automatically.

For instance, here’s a simplified ChatGPT instruction:

{% code overflow="wrap" fullWidth="false" %}

```
Task: Generate a CSV file with 20 prompts following the template of the provided CSV file.

Context: The prompts will be used to create sticker designs for the Christmas Holidays. Ensure the prompts are diverse, creative, and engaging.

Settings: Use 1:1 aspect ratio, set visibility to private, model to 2.0, rendering to "default", magic prompt to "on" and use "design" as style.

Please follow the language style of the following examples:

1- A sticker design of a cartoon-like figure with a cheerful expression holding a brain upright. The figure is standing on a cloud. There is a speech bubble above its head that reads, "HEY, YOU DROPPED THIS!".

2- A sticker design of a stylized, cartoon-like depiction of a fox. The fox appears to be curled up, with its tail wrapped around its body. Its eyes are closed, giving it a peaceful or sleepy expression. The fox is predominantly orange with white accents, especially around its muzzle and eyes. The fox is set against a white background.

3- A sticker design of a cute cat with a curious expression peeking out of a cardboard box where it barely fits. The cat is sitting on the edge of the box. The text "If I Fits, I Sits" is written in a quirky font below the cat. The background is white.

4- A sticker illustration of a whimsical and adorable cartoon sloth relaxing in a hammock, hanging between two palm trees on a beach. The sloth is wearing stylish sunglasses and has a relaxed grin. The background contains a serene blue sky, fluffy white clouds, and a few other palm trees.

5- A charming and whimsical sticker design featuring a sleepy owl perched on a book, its eyes half-closed. The background neutral grey and the sticker has a thick white outline.

6- A vibrant, retro-inspired sticker with bold white outlines. The motivational phrase "NEVER GIVE UP!" is written in a dynamic, flowing cursive font reminiscent of 1950s Americana signage. The text has a subtle neon glow. The phrase is surrounded by playful, abstract shapes and vintage-inspired patterns. The overall design is bright, cheerful, and evokes energy and optimism.

```

{% endcode %}

Here are some results showing Christmas sticker designs generated via Batch + ChatGPT workflow.

<div><figure><img src="https://1799634369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzjhNby3LLsIikYuvxAJP%2Fuploads%2FNN6X3Nmp5HsGLbLbs3Sa%2F0016_4_a-sticker-design-of-a-cheerful-santa-cla_vGcBcowbTYm2RyjQECbEVA_azoXyMmuQVmLlRZnOaUiog.png?alt=media&#x26;token=7f29b64c-b6e0-4a96-a583-2e7acc2cc592" alt=""><figcaption></figcaption></figure> <figure><img src="https://1799634369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzjhNby3LLsIikYuvxAJP%2Fuploads%2FSEldxJKbwlk9oSq6yAop%2F0007_4_a-sticker-design-of-a-sleigh-filled-with_d3TmMb-aSku89AdkRIu0Xg_zSBmHGwiTt6G84dy275c2w_cover.png?alt=media&#x26;token=7834d10d-b2e6-4521-a962-8658868c8545" alt=""><figcaption></figcaption></figure> <figure><img src="https://1799634369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzjhNby3LLsIikYuvxAJP%2Fuploads%2Ffh1Q0UnPnCkcVFt7TJC4%2F0004_4_a-sticker-design-of-a-whimsical-christma_obdGyJaxTvyBCiRL_mVFpQ_v1t_Zv7OTEKwZBMPjYfvIw_cover.png?alt=media&#x26;token=e09df7c5-5415-446f-beef-ebfa183ce606" alt=""><figcaption></figcaption></figure> <figure><img src="https://1799634369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzjhNby3LLsIikYuvxAJP%2Fuploads%2Fkk5fCvNhx5v65z2oiKzw%2F0003_4_a-sticker-design-of-a-joyful-puppy-weari_e4ENPhHMRtKqSEW89XsT5g_uUMoGRJIQLqvh3YyBW-Xfw_cover.png?alt=media&#x26;token=dee30029-95a1-4a82-b12e-cd31e5d98704" alt=""><figcaption></figcaption></figure></div>

For other advanced use cases, see the [Batch Generaion](https://about.ideogram.ai/batch) blog post.