# 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 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**.
Batch Generation interface showing upload and status areas

Batch Generation interface showing upload and status areas.

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 **500 rows**, 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.

Example of an error message during file upload.

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.

Batch Generation interface showing uploaded file details and Replace option.

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.

Notification shown when Batch Generation completes successfully.

{% 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 %}
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.

The Download icon is located at the right end of the status row.

## Expected Values The table below lists all recognized column names, valid inputs, and default settings for Batch Generation.
ColumnValid valuesDefault
promptAny text *Required—
visibilitypublic, private *Required—
aspect_ratioPredefined aspect ratio, (e.g., 16:9). See Aspect Ratios1:1
magic_prompton, offon
model3.0, 2.0, 2a, 1.02.0
num_imagesAny whole number from 1 to 44
seed_numberAny whole number from 0 to 2147483647—
renderingdefault, turbo, qualitydefault
negative_promptAny keywords separated by commas—
style

3.0: auto, general, realistic, design

2.0: auto, general, realistic, design, 3d, anime


1.0: Same as 2.0. Use v1.0 keywords in the prompt.

auto
color_palette

Up to five (5) hexadecimal RGB values separated with spaces. Ex.: #CBA324 #F86C14 #C71E71

or any preset Color palette name:
ember, fresh, jungle, magic, melon, mosaic, pastel, ultramarine

Only available in Model 2.0 or later.

—
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.
For other advanced use cases, see the [Batch Generaion](https://about.ideogram.ai/batch) blog post. --- # Agent Instructions: 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= ``` 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.