🟦 Get from list

The Retrieve from a list block allows you to precisely access an element stored in a collection (list/array) by specifying its index.

This block is essential for manipulating structured data, such as extracting a user choice, displaying a specific element of a ranking, or retrieving a previously selected random value.

📥 Entries

• list (List/Array): The source collection containing the elements to browse.
• index (Number): The numerical position of the element to extract (1 for the first element, 2 for the second, etc.).

📤 Outings

• element (Dynamic variable): The value extracted at the specified index, whose type depends on the contents of the list (text, number, image, etc.).

💡 Example of use

Scenario: Display the middle name of a list of participants

1. You have a first names list containing ["Emma", "Lucas", "Chloé", "Noah"] in your graph.
2. You want to display only the middle name in a speech bubble.
3. Use the Retrieve from list block and connect the first names variable to the list input.
4. Enter 2 in the index entry to target the second element.
5. The output element returns "Lucas", which you can directly display or use in the rest of the flow.

⚙️ Technical Details

• Error handling: If the index exceeds the list size, the output will be null (undefined), which may break the flow if not handled downstream.
• Indexing: Celestory uses readable numbering (1 = first element) to simplify list manipulation.

Updated on: 04/03/2026