Modifier Blocks
Shuffle Block
Modifier Blocks
Shuffle Block
Randomize the order of elements in an array
Overview
The Shuffle Block randomizes the order of elements in an array. It’s like shuffling a deck of cards - you give it a list of items, and it mixes them up into a random order. This is useful when you want to randomize a playlist, create random selections, or add variety to any ordered list.
Key Features
- Randomly reorders any list of items
- Creates a new shuffled list (keeps your original list unchanged)
- Works with any type of items (numbers, text, objects, etc.)
- Automatically handles single items by treating them as a one-item list
Inputs
The list of items you want to shuffle. If you input a single item instead of a list, it will be treated as a one-item list.
Outputs
A new list containing all your input items in a random order.
Example: Shuffle a List of Numbers
- Create an Array Block with numbers
[1, 2, 3, 4, 5] - Add a Shuffle Block and connect the Array Block to its
arrayinput - Run the flow. The Shuffle Block’s
shuffledoutput will contain the same numbers in a random order, like[3, 1, 5, 2, 4]
Error Handling
- If nothing is connected to the input, the block will output an empty list
- If you input a single item instead of a list, it will work fine - it just treats it as a one-item list