NEW Explore the Scratch Block Dictionary, tutorials, textbook, and classroom guides

Start learning →

Troubleshooting Common Scratch Issues

📌 What you will learn

Quick diagnostic steps when a sprite will not move, sound does not play, clones stop appearing, or a project lags.

Top 5 bugs and how to fix them

When something breaks, do not delete your code right away. Check one likely cause at a time:

  • Sprite does not move: check if the script has a hat block ("When green flag clicked") and is not blocked by a missing "forever" loop.
  • Sprite is missing: check "show", size (100%), ghost effect (0), layer ("go to front"), and coordinates (x: 0, y: 0).
  • No sound plays: check browser tab mute, device volume, sprite volume ("set volume to 100%"), and whether a "play sound until done" is blocking other code.
  • Clones stop spawning: Scratch limits active clones to 300—make sure finished clones run "delete this clone".
  • Project runs slowly: avoid running heavy "touching color" checks inside dozens of forever loops at once.

The golden debugging habit

Temporarily display key variables on the stage so you can watch score, speed, or state change live while the project runs. Seeing the numbers makes invisible bugs immediately obvious.

This guide is provided for educational purposes. Scratch screens and terms may change over time, so please check the official Scratch website as well.