How to Use random.shuffle in Python

What you’ll build or solve

You’ll shuffle a list in Python with random.shuffle(), confirm the list changed, and avoid mistakes like expecting a returned value.

When this approach works best

This approach works best when you need to:

• Randomize items in place, like shuffling a deck of cards or quiz questions.
• Shuffle a list before picking the first N items as a quick sample.
• Create a different order each run for demos or small games.

Avoid this approach when:

• You need a shuffled copy while keeping the original list unchanged. Use a shuffled copy pattern instead.
• You are shuffling for security, like passwords or tokens. Use the secrets module for security-related randomness.

Prerequisites

• Python 3 installed
• You know what a list is
• You can run a short Python script

Step-by-step instructions

1) Shuffle a list in place

random.shuffle() changes the list you pass in.

importrandom

cards= ["A","K","Q","J"]
random.shuffle(cards)
print(cards)

What to look for:

The list order changes, and shuffle() does not return a new list.

2) Keep the original list by shuffling a copy

Copy the list first, then shuffle the copy.

importrandom

original= ["Ana","Bo","Chen","Dina"]
shuffled=original.copy()

random.shuffle(shuffled)

print("original:",original)
print("shuffled:",shuffled)

3) Shuffle with repeatable results using a seed

Set a seed when you want the same shuffle every run, such as in tests.

importrandom

items= [1,2,3,4,5]

random.seed(123)
random.shuffle(items)

print(items)

What to look for:

The same seed plus the same sequence of random calls produces the same order.

4) Get a shuffled copy with random.sample()

Use this when you want a new shuffled list and do not want to mutate the original.

importrandom

names= ["Ana","Bo","Chen","Dina"]
shuffled=random.sample(names,k=len(names))

print("original:",names)
print("shuffled:",shuffled)

Examples you can copy

1) Shuffle quiz questions before showing them

importrandom

questions= [
"What does len() return?",
"What is a list index?",
"What does import do?",
"What is a function?",
]

random.shuffle(questions)

forqinquestions:
print(q)

2) Shuffle a deck and draw the top 5 cards

importrandom

deck= ["A♠","K♠","Q♠","J♠","10♠","9♠","8♠"]
random.shuffle(deck)

hand=deck[:5]
print(hand)

3) Shuffle pairs while keeping items together

importrandom

pairs= [("Ana","blue"), ("Bo","green"), ("Chen","red")]
random.shuffle(pairs)

forname,colorinpairs:
print(name,color)

Common mistakes and how to fix them

Mistake 1: Expecting shuffle() to return a list

You might write:

importrandom

nums= [1,2,3]
shuffled=random.shuffle(nums)
print(shuffled)

Why it breaks:

random.shuffle() returns None, so shuffled becomes None.

Correct approach:

importrandom

nums= [1,2,3]
random.shuffle(nums)
print(nums)

Mistake 2: Passing a tuple or string to shuffle()

You might write:

importrandom

text="abcd"
random.shuffle(text)

Why it breaks:

shuffle() needs a mutable sequence. Strings and tuples cannot be shuffled in place.

Correct approach:

importrandom

text="abcd"
chars=list(text)

random.shuffle(chars)
print("".join(chars))

Mistake 3: Accidentally changing a list you wanted to keep

You might write:

importrandom

names= ["Ana","Bo","Chen"]
random.shuffle(names)
print(names)

Why it breaks:

shuffle() changes the list in place, so you lose the original order.

Correct approach:

importrandom

names= ["Ana","Bo","Chen"]
shuffled=names.copy()

random.shuffle(shuffled)
print("original:",names)
print("shuffled:",shuffled)

Troubleshooting

If you see NameError: name 'random' is not defined, add import random at the top of your file.

If you see TypeError when calling shuffle(), confirm you passed a list, not a tuple or string.

If your results look the same between runs, check if you called random.seed(...) earlier in your program.

If you need a shuffled copy without changing the original list, copy the list before shuffling or use random.sample().

Quick recap

• Use random.shuffle(my_list) to shuffle a list in place.
• shuffle() returns None, so check the list itself after shuffling.
• Keep the original by shuffling a copy with my_list.copy().
• Use random.seed(...) when you need repeatable shuffles.
• Use random.sample(my_list, k=len(my_list)) when you need a shuffled copy.