> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stratumn.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction to Generations

> Your way to update your workflows

# What is a Generation ?

A generation is the process of updating your workflows with **Database's data**. It triggers an **asynchronous process** in the background that will update your workflows with the latest data from your Database.

<img src="https://mintcdn.com/stratumn/4rAewZdM7szac3r3/studio/generation/images/generations.jpg?fit=max&auto=format&n=4rAewZdM7szac3r3&q=85&s=293479a05b7265d8d7659abb4f06953c" style={{ borderRadius: '1rem' }} width="1806" height="802" data-path="studio/generation/images/generations.jpg" />

## Generation history

The generation history is a **paginated list** of all the generations that have been triggered, it is ordered by creation date in a **descending** order.

You can find the following information in the generation history:

<img src="https://mintcdn.com/stratumn/4rAewZdM7szac3r3/studio/generation/images/oneGeneration.jpg?fit=max&auto=format&n=4rAewZdM7szac3r3&q=85&s=61d19324dcd43ceda29cb9e224a40590" style={{ borderRadius: '1rem' }} width="1307" height="92" data-path="studio/generation/images/oneGeneration.jpg" />

* **Generation ID**: A random ID generated by the system to identify the generation.
* **Currently deployed**: A little blue chip named **Current** will show the currently deployed generation.
* **Target environment**: The environment where the generation will be applied, it can be **Production** or **Staging** or **Pre-Production**.
* **Generation status**: The status of the generation, it can be **Pending**, **Timeout**, **Ready** or **Failed**.
* **Generation duration**: The duration of the generation.
* **Generation time elapsed**: The time elapsed since the generation was triggered.
* **Generation source**: The image source tag of the generation, reserved for Stratumn team.
* **Generation author**: The user who triggered the generation.

## Triggering a generation

To trigger a generation, you can click the **Generate button** in the top right corner of your screen.

<img src="https://mintcdn.com/stratumn/4rAewZdM7szac3r3/studio/generation/images/generate.jpg?fit=max&auto=format&n=4rAewZdM7szac3r3&q=85&s=248c8f48af6f570a8b25427907d4127c" style={{ borderRadius: '1rem' }} width="349" height="57" data-path="studio/generation/images/generate.jpg" />

The newly triggered generation will automatically be added on top the first page of generation history.

<img src="https://mintcdn.com/stratumn/4rAewZdM7szac3r3/studio/generation/images/pending.jpg?fit=max&auto=format&n=4rAewZdM7szac3r3&q=85&s=c5db4fcfe64bb600b7e702c6e51dd240" style={{ borderRadius: '1rem' }} width="1341" height="216" data-path="studio/generation/images/pending.jpg" />

### Rate limit

Currently, you can trigger a maximum of **3 generations per minute**.
