Convert Zip To Sb3 [better] -
How to Convert a ZIP File to an SB3 File
If you have a folder full of Scratch assets (sprites, sounds, costumes, and JSON code) or a modified project archive, you may need to convert it into an SB3 file to upload it to the Scratch website or open it in the Scratch app.
The good news? An SB3 file is actually a standard ZIP archive with a different file extension. Here’s how to convert one to the other.
Step 2: The Extension Swap
- Locate your file:
filename.zip. - Windows: If you don't see the
.zippart, open File Explorer, go to the View tab, and check File name extensions. - Right-click the file and select Rename.
- Change
.zipto.sb3. - Windows will ask: "If you change a file name extension, the file might become unusable..." Click Yes.
Congratulations. You have just converted a Zip to an SB3. Double-click the file, and it should launch in the Scratch Offline Editor. convert zip to sb3
Step-by-Step:
-
Extract your ZIP file if you haven’t already. You should see a folder containing:
project.json(the main file)- A folder named
assets/or individual asset files (.svg,.png,.wav,.mp3)
-
Select all contents inside the folder – not the folder itself. Use
Ctrl+A(Windows/Linux) orCmd+A(Mac). How to Convert a ZIP File to an -
Compress/zip the selected items:
- Windows: Right-click → “Send to” → “Compressed (zipped) folder”
- Mac: Right-click → “Compress X items”
- Linux: Use archive manager or
zip -r newfile.zip *
-
Rename the resulting ZIP file to end with
.sb3(likemyproject.sb3). Locate your file: filename -
Test by dragging into the Scratch editor.
When you might need this
- You received a Scratch project as a folder or ZIP from another user or backup export.
- You exported assets separately and need to repackage them into an .sb3.
- You’re building tools that generate Scratch projects programmatically.
Common pitfalls and troubleshooting
- project.json nested in a subfolder: Scratch won’t find it—repackage so project.json is at root.
- Wrong asset paths or missing files: sprites or sounds appear blank or errors occur.
- Corrupted JSON: validate project.json with a JSON linter.
- File permissions: ensure files are readable when packaging.
- Large assets: size limits may apply when uploading to the Scratch website.
Method 2: Re-Zipping a Folder into SB3 (For Extracted Projects)
If you have unzipped an SB3 to edit its contents, or if your ZIP contains a folder with assets, follow this method.
For Chromebook:
- Use the Files app.
- Right-click the ZIP and select Rename.
- Type the new name ending in
.sb3. - Upload to the Scratch editor using the “Load from your computer” option.
Important: This only works if the ZIP file’s internal structure matches an SB3. If it contains a folder called something like
project/that holds the JSON file, simple renaming will fail. Use Method 2 instead.