🏠 All Projects Reference

🧱 Every Scratch Block

Every block in Scratch, grouped by the sidebar tab it lives in — the same colors and tabs as the real editor, shown as the actual block shape you'd drag out of the palette. This is our checklist: this project's whole idea is to eventually teach every single one of these through a real, buildable project. Each block links to the project that teaches it.

141 / 141 blocks taught so far
Motion 18 / 18 taught
1
move 10 steps

Moves the sprite forward the number of steps you choose, in whatever direction it's currently facing.

1
turn 15 degrees

Rotates the sprite clockwise by the number of degrees you choose.

1
turn 15 degrees

Rotates the sprite counter-clockwise by the number of degrees you choose.

1
go to random position

Jumps the sprite instantly to a random spot, the mouse pointer, or another sprite's position.

1
go to x: 0 y: 0

Jumps the sprite instantly to an exact x/y position on the stage.

1
glide 1 secs to random position

Smoothly slides the sprite to a random spot, the mouse pointer, or another sprite over a number of seconds.

1
glide 1 secs to x: 0 y: 0

Smoothly slides the sprite to an exact x/y position over a number of seconds.

1
point in direction 90

Turns the sprite to face an exact compass direction (0 = up, 90 = right, 180 = down, -90 = left).

1
point towards mouse-pointer

Turns the sprite to face the mouse pointer or another sprite, whatever way that takes.

1
change x by 10

Nudges the sprite left/right along the x-axis, no matter which way it's facing.

1
set x to 0

Jumps the sprite to an exact x position, leaving y unchanged.

1
change y by 10

Nudges the sprite up/down along the y-axis, no matter which way it's facing.

1
set y to 0

Jumps the sprite to an exact y position, leaving x unchanged.

1
if on edge, bounce

If the sprite has reached the edge of the stage, turns it around as if it bounced off a wall.

1
set rotation style left-right

Chooses how the sprite visually turns: spin all the way around, only flip left-right, or never rotate at all.

x position

Reports the sprite's current left/right position on the stage.

y position

Reports the sprite's current up/down position on the stage.

direction

Reports which way the sprite is currently facing, in degrees.

Looks 21 / 21 taught
1
say Hello! for 2 seconds

Shows a speech bubble with your text for a set number of seconds, then it disappears on its own.

1
say Hello!

Shows a speech bubble with your text that stays up until something else changes or clears it.

1
think Hmm... for 2 seconds

Shows a thought bubble with your text for a set number of seconds, then it disappears on its own.

1
think Hmm...

Shows a thought bubble with your text that stays up until something else changes or clears it.

1
switch costume to costume2

Instantly switches the sprite to a specific costume by name.

1
next costume

Switches the sprite to the next costume in its list, wrapping back to the first after the last.

1
switch backdrop to backdrop2

Instantly switches the stage to a specific backdrop by name.

1
switch backdrop to backdrop2 and wait

Switches the backdrop AND pauses this script until every "when backdrop switches to" script elsewhere has finished running.

1
next backdrop

Switches the stage to the next backdrop in its list, wrapping back to the first after the last.

1
change size by 10

Nudges the sprite's size up (or down, with a negative number) by a percentage.

1
set size to 100 %

Jumps the sprite straight to an exact size, as a percentage of its normal size (100 = normal).

1
change color effect by 25

Nudges a graphic effect (color, fisheye, whirl, pixelate, mosaic, brightness, or ghost) up or down.

1
set ghost effect to 50

Jumps a graphic effect straight to an exact value.

1
clear graphic effects

Resets every graphic effect on the sprite back to normal, all at once.

1
show

Makes the sprite visible on the stage.

1
hide

Makes the sprite invisible on the stage (it's still there, just not shown).

1
go to front layer

Moves the sprite in front of, or behind, every other sprite on the stage.

1
go forward 1 layers

Nudges the sprite forward or backward past a number of other sprites, instead of jumping all the way to front/back.

costume number

Reports the sprite's current costume, either as a number (its position in the list) or its name — pick which from the block's own dropdown.

backdrop name

Reports the stage's current backdrop, either as a number or its name — the backdrop version of costume ().

size

Reports the sprite's current size as a percentage.

Sound 9 / 9 taught
1
play sound Meow until done

Plays a sound and pauses the script until it finishes playing.

1
start sound Meow

Starts a sound playing in the background and immediately moves on to the next block, without waiting.

1
stop all sounds

Immediately stops every sound playing, on every sprite.

1
change pitch effect by 10

Nudges a sound effect (pitch or pan left/right) up or down.

1
set pitch effect to 50

Jumps a sound effect straight to an exact value.

1
clear sound effects

Resets every sound effect back to normal, all at once.

1
change volume by 10

Nudges the sprite's volume up or down by a percentage.

1
set volume to 100 %

Jumps the sprite's volume straight to an exact percentage.

volume

Reports the sprite's current volume as a percentage.

Events 8 / 8 taught
1
when clicked

Starts this script the moment the green flag above the stage is clicked — the most common way to start a project.

1
when space key pressed

Starts this script the instant a specific keyboard key is pressed.

1
when this sprite clicked

Starts this script the instant this sprite is clicked or tapped.

1
when backdrop switches to backdrop2

Starts this script the instant the stage switches to a specific backdrop.

1
when timer > 10

Starts this script automatically the instant a live value (the timer or the microphone's loudness) crosses a number you set.

1
when I receive message1

Starts this script the instant a specific broadcast message is sent, from anywhere in the project.

1
broadcast message1

Sends a message to every script listening for it, then immediately moves on without waiting.

1
broadcast message1 and wait

Sends a message AND pauses this script until every script that received it has finished running.

Control 11 / 11 taught
1
wait 1 seconds

Pauses this script for a set number of seconds before moving on to the next block.

1
repeat 10
1
move 10 steps

Runs the blocks inside it an exact number of times, then moves on.

1
forever
1
move 10 steps

Runs the blocks inside it over and over, forever — the only way to stop it is clicking the red stop sign, or a stop block.

1
if touching mouse-pointer ? then
1
say Hi!

Runs the blocks inside it only if the hexagon question is true — skips them entirely if it's false.

1
if touching mouse-pointer ? then
1
say Hi!
else
1
say Bye!

Runs the FIRST set of blocks if the hexagon is true, or the SECOND set if it's false — one or the other always runs.

1
wait until touching mouse-pointer ?

Freezes this script, doing nothing at all, until the hexagon question becomes true.

1
repeat until touching mouse-pointer ?
1
move 10 steps

Runs the blocks inside it over and over until the hexagon question becomes true, then stops.

1
stop all

Stops scripts — pick "all" to stop the whole project, "this script" to stop just this one, or "other scripts in sprite" for every other script on this sprite.

1
when I start as a clone

Starts this script the instant a new clone of this sprite is created — runs once per clone, separately.

1
create clone of myself

Makes a full, independent copy of a sprite (usually "myself") — the copy starts invisible until shown.

1
delete this clone

Deletes just the one clone running this script — never the original sprite.

Sensing 18 / 18 taught
touching mouse-pointer ?

A yes/no question: is the sprite currently touching the mouse pointer, the edge, or another sprite?

touching color ?

A yes/no question: is the sprite currently touching a specific color, picked with a real color swatch?

color is touching ?

A yes/no question: is one specific color on THIS sprite touching another specific color anywhere on the stage?

distance to mouse-pointer

Reports exactly how many steps away the mouse pointer or another sprite currently is.

1
ask What's your name? and wait

Pops up a text box on the stage for the player to type into, and pauses the script until they press Enter.

answer

Reports whatever the player last typed into an "ask and wait" box.

key space pressed?

A yes/no question: is a specific keyboard key currently being held down?

mouse down?

A yes/no question: is the mouse button currently being held down?

mouse x

Reports the mouse pointer's current left/right position on the stage.

mouse y

Reports the mouse pointer's current up/down position on the stage.

1
set drag mode draggable

Lets a player pick up and drag the sprite around with the mouse WHILE the project is running.

loudness

Reports how loud the real microphone is picking up right now — needs microphone permission, and reports 0 until it's granted.

timer

Reports how many seconds it's been since the timer was last reset (or since the project started).

1
reset timer

Resets Scratch's built-in stopwatch back to zero.

x position of Sprite1

Peeks at another sprite's (or the stage's) own values, like its x position or one of its variables.

current year

Reports a piece of the real, live date/time — year, month, date, day of week, hour, minute, or second.

days since 2000

Counts every day that's passed since January 1st, 2000 — no inputs, always ticking upward.

username

Reports the username of whoever's logged into scratch.mit.edu right now — empty if nobody is.

Operators 18 / 18 taught
2 + 3

Reports the sum of two numbers.

5 − 2

Reports the difference of two numbers.

4 × 3

Reports the product of two numbers.

10 / 2

Reports one number divided by another.

pick random 1 to 10

Reports a different random number (within the range you set) every time it runs.

5 > 3

A yes/no question: is the first number bigger than the second?

3 < 5

A yes/no question: is the first number smaller than the second?

5 = 5

A yes/no question: are these two values exactly equal?

5 > 3 and 2 < 10

A yes/no question that's true only when BOTH of its two hexagons are true.

5 > 3 or 2 > 10

A yes/no question that's true when EITHER of its two hexagons is true.

not touching mouse-pointer ?

Flips a hexagon's answer — true becomes false, and false becomes true.

join Hello World

Glues two pieces of text together into one.

letter 1 of Cat

Reports just one character from a piece of text, counting from 1.

length of Scratch

Counts the characters in a piece of text.

Scratch contains cat?

A yes/no question: does one piece of text show up somewhere inside another?

7 mod 2

Reports what's left over after dividing one number by another (the remainder).

round 3.7

Rounds a decimal number to the nearest whole number.

sqrt of 16

One block with a dropdown full of math functions — absolute value, floor, ceiling, square root, sin, cos, tan, and more.

Variables 5 / 5 taught
score

Reports whatever number or text is currently stored in a variable you made.

1
set score to 0

Replaces whatever's in a variable with an exact new value.

1
change score by 1

Adds to whatever's currently in a variable, instead of replacing it.

1
show variable score

Puts a little scoreboard for this variable on the stage, always live and up to date.

1
hide variable score

Hides the variable's on-stage scoreboard again.

Lists 12 / 12 taught
groceries

Reports every item in a list joined together at once, space-separated.

1
add apple to groceries

Adds a new item to the very end of a list.

1
delete 1 of groceries

Removes one item from a list, counting position from 1.

1
delete all of groceries

Empties a whole list at once.

1
insert banana at 1 of groceries

Squeezes a new item into the middle of a list at an exact position, instead of adding it at the end.

1
replace item 1 of groceries with orange

Changes one item in a list in place, without shifting anything else around.

item 1 of groceries

Reports whatever item is sitting at an exact position in a list.

item # of apple in groceries

Reports WHERE a value sits in a list — the reverse of item-of-list.

length of groceries

Counts how many items are in a whole list.

groceries contains apple?

A yes/no question: does this item show up anywhere in the list?

1
show list groceries

Puts a list on the stage as a visible, scrollable box.

1
hide list groceries

Hides a list's on-stage box again.

My Blocks 2 / 2 taught
1
define jump

The "define" hat — where you build what a custom block actually does, once. Appears when you click Make a Block.

1
jump

Your own custom block, in whatever color/shape/name you gave it — drop it anywhere to run that whole mini-script in one step.

Pen (extension) 9 / 9 taught
1
erase all

Wipes every pen trail and stamp off the stage at once.

1
stamp

Leaves a permanent copy of exactly how the sprite looks right now glued onto the stage — the copy doesn't move even after the sprite does.

1
pen down

Starts drawing a trail behind the sprite as it moves, like a real pen touching paper.

1
pen up

Lifts the pen back up, so moving no longer draws a trail.

1
set pen color to

Sets the pen's color using a real color swatch — click it in Scratch to pick any color.

1
change pen color by 10

Nudges a pen property (color, saturation, brightness, or transparency) up or down by an exact amount.

1
set pen color to 50

Jumps a pen property straight to an exact number, instead of nudging it.

1
change pen size by 10

Nudges the pen's line thickness up (or down, with a negative number).

1
set pen size to 5

Jumps the pen's line thickness straight to an exact number.

Music (extension) 7 / 7 taught
1
play drum (1) Snare Drum for 0.25 beats

Plays one of Scratch's built-in drum sounds for a number of beats.

1
rest for 0.25 beats

Plays silence for a number of beats — the musical pause between notes.

1
play note 60 for 0.25 beats

Plays an exact musical pitch (piano-key numbered, 60 = middle C) for a number of beats.

1
set instrument to (1) Piano

Changes what "play note" sounds like — piano, guitar, sax, and more.

1
set tempo to 60

Sets exactly how fast every note and rest plays, in beats per minute.

1
change tempo by 20

Nudges the tempo up or down from wherever it currently is.

tempo

Reports the current tempo as a number.

Text to Speech (extension) 3 / 3 taught
1
speak Hello!

Reads text out loud through real computer speech, and pauses the script until it finishes talking.

1
set voice to alto

Changes what "speak" sounds like — alto, tenor, squeak, giant, kitten, and more.

1
set language to English

Changes what language "speak" reads text in — dozens of real languages.