Step-by-step guide to uploading Playable Bundle ZIP files
How to Upload Your Playable Bundle ZIP Files to YouTube Playables
I remember the first time I tried to upload my game to YouTube Playables. I had the ZIP file ready. I felt confident. Then I opened YouTube Studio and stared at the screen for ten minutes because I could not find where to upload.
Turns out, the process is simple once you know it. But nobody explains the small details. Like what to name your files. Or what happens after you click upload. Or why your ZIP file might get rejected even though everything looks fine.
Let me walk you through every single step. From preparing your folder to seeing that green success message.
Before You Even Open YouTube
Do not open your browser yet. First, get your files ready on your computer. This step saves you from uploading multiple broken versions.
Create a new folder on your desktop. Name it something simple like mygame_upload. No spaces. No special characters. Just letters and maybe an underscore.
Inside this folder, put your index.html file. This is the file that loads first when someone plays your game. Make sure it is named exactly index.html. Lowercase. Nothing else.
Put your CSS files. Your JavaScript files. Your images. Your sounds. Keep everything organized. If you have many images, put them in a subfolder called assets. If you have sounds, put them in a sounds subfolder. YouTube does not require this structure, but it keeps things clean.
Now open every file path in your code. Check that you are not using absolute paths. An absolute path looks like C:/Users/YourName/Desktop/mygame/image.png or /Users/YourName/Documents/game/style.css. These will break on YouTube. Change them to relative paths. Like assets/image.png or ../sounds/click.mp3.
Next, open your index.html in a browser. Play your game completely. Not just the first level. Play until you hit a natural stopping point. Close the browser. Open it again. Play again. If anything breaks, fix it now.
Once everything works, select all files and folders inside your mygame_upload folder. Right click. Choose compress or send to compressed folder. On Windows, this creates a ZIP file. On Mac, it creates a ZIP file too. Name this ZIP file something short. mygame_v1.zip works fine.
Do not compress the folder itself. Compress the contents. This is a common mistake. If you compress the folder, your ZIP file will have an extra folder inside it. YouTube wants the index.html file to be at the root of the ZIP, not inside another folder.
Finding the Upload Section in YouTube Studio
Now open YouTube Studio. Not regular YouTube. YouTube Studio. The link is studio.youtube.com.
Log into the account you want to use for Playables. Make sure this account has Playables access. If you do not see the Playables tab, you need to request access first. That is a separate process.
Once you are in YouTube Studio, look at the left sidebar. You see Dashboard, Content, Analytics, Comments, and so on. Scroll down. Look for a tab that says Playables. If you do not see it, your account might not have access yet. Some accounts get it automatically. Others need to wait.
Click the Playables tab. The page that opens shows your existing playable games if you have any. If this is your first time, it will be mostly empty. There will be a button somewhere on this page. On the top right usually. It says things like New playable or Create or Submit. Click that button.
The Submission Form Walkthrough
A form opens. It looks simple but pay attention to every field.
First field is Game title. Write the name of your game exactly as you want players to see it. Do not use all capital letters. Do not add emojis unless they are part of your brand. Keep it under sixty characters. YouTube might cut off longer titles.
Example of a good title: Color Match Quick Tap
Example of a bad title: THE MOST AMAZING COLOR GAME EVER YOU WILL LOVE IT
Second field is Short description. You have about two hundred characters here. Describe what the player actually does. Not what they feel. What they do.
Good description: Tap the colored tile that matches the word shown. Beat the timer to earn points.
Bad description: This game is super fun and exciting and you will not believe how amazing it is.
Third field is Category. YouTube gives you a dropdown menu. Choose the one that fits best. Puzzle for puzzle games. Action for fast reaction games. Arcade for classic style games. If your game fits multiple categories, pick the most obvious one.
Fourth field is Language. Choose the primary language of your game. If your game has no words, English is fine.
Now the thumbnail section. You need a JPEG or PNG image. Size must be 1280 by 720 pixels. Do not upload a blurry image. Do not upload a screenshot full of debug text. Make a clean image showing your game in action. Put the game title on the image. Use a readable font. Keep it simple.
Finally, the file upload section. Click the button that says Upload or Choose file. Select your ZIP file from your computer. The upload starts. Depending on your internet speed and file size, this takes anywhere from a few seconds to a minute.
What Happens During Upload
While the ZIP file uploads, YouTube runs some basic checks. They look at the file size. They check if the ZIP is corrupted. They make sure index.html exists at the root.
If something fails here, you see an error message immediately. Common errors at this stage:
Your ZIP file is empty. That means you compressed an empty folder by mistake.
Your ZIP file does not contain index.html. Check your file name. Maybe you named it Index.html with a capital I. Change it to lowercase and try again.
Your ZIP file is too large. The upload button might not even let you select it. Reduce your file size and try again.
If the upload completes without errors, you see a success message. YouTube now has your file. But you are not done yet.
The Sandbox Testing Step
After upload, YouTube puts your game into a sandbox. This is a private testing environment. Only you can see it. This is where you play your game exactly as YouTube sees it.
Click the Test button next to your uploaded game. A new tab opens. Your game loads. But this time, it loads inside YouTube Playables player. Not your local browser.
Play your game thoroughly. Tap every button. Try to break it. Rotate your screen if you are on mobile. Close the tab and open it again.
If you find any problem, go back to your game files on your computer. Fix the problem. Create a new ZIP file. Upload it again. YouTube lets you upload multiple versions. Each new version replaces the old one in the sandbox.
Keep testing until you cannot find any issues. Then ask a friend to test. Friends find problems you miss because they play differently than you do.
Submitting for Review
Once you are satisfied with sandbox testing, go back to the submission form. There should be a button that says Submit for review or something similar. Click it.
YouTube now asks for confirmation. Are you sure your game follows their guidelines? Are you sure you have tested everything? Click yes.
Your game status changes from Draft to In review. You cannot make changes now. If you realize you forgot something, you have to wait until the review completes or cancel the submission.
What the Review Process Looks Like
YouTube does not review games immediately. They have a team of people who test each submission. The review takes anywhere from three days to two weeks.
During this time, you can check the status in YouTube Studio. Go back to the Playables tab. Look at your submission. It will say In review.
Do not submit the same game multiple times. That does not speed anything up. It just annoys the reviewers. Submit once. Wait patiently.
While waiting, you can work on your next game. Or improve your current game based on things you noticed during sandbox testing. But do not upload changes while the review is in progress. Wait for the result.
After Review Approval
If YouTube approves your game, you get an email. The status changes to Live or Published. YouTube gives you a direct link to your game. It looks something like youtube.com/playables/ followed by some random characters.
Copy that link. Save it somewhere. You will need it when you promote your game.
Your game now appears in YouTube Playables. People can find it through search. YouTube might also recommend it to users based on their interests.
You can see analytics for your game. Go to the Playables tab. Click on your game. You see how many plays it got. How long people played. Where they quit. Use this data to improve your game.
You can also upload new versions of your game after approval. If you find a bug or add a new feature, create a new ZIP file and upload it. YouTube reviews the update too. But updates usually go faster than first-time submissions.
After Review Rejection
If YouTube rejects your game, you get an email with a reason. Read it carefully. YouTube tells you exactly what failed.
Common rejection reasons at the upload stage:
- Your game crashed during testing. Go back and fix the crash.
- Your game did not load within time limits. Reduce file size or optimize loading.
- Your game had external network calls. Remove any code that fetches data from the internet.
- Your viewport handling was broken. Fix how your game responds to screen size changes.
- Your thumbnail was misleading. Replace it with an honest screenshot.
Once you fix the problem, create a new ZIP file. Upload it again. Start the submission process over. Do not feel bad. Most games get rejected at least once. My own game got rejected twice before approval.
A Quick Summary of the Whole Process
Open YouTube Studio. Click Playables tab. Click New playable button. Fill the form with title, description, category, language. Upload your thumbnail. Upload your ZIP file. Test in sandbox. Fix problems. Test again. Submit for review. Wait for email. Get approval or rejection. If rejected, fix and resubmit.
That is it. No magic. No secrets. Just a clear path from your computer to YouTube.
One Last Piece of Advice
Do not rush the sandbox testing. I know you want to see your game live. I know you are excited. But rushing leads to rejection. And rejection takes days to come back. Then you fix and wait again. A few extra hours of testing saves you days of waiting.
Test on real devices if you can. Test on a phone. Test on a tablet. Test on a laptop. Each device shows different problems.
And when you finally get that approval email, take a moment to enjoy it. You earned it.
Good luck with your upload.