Tiled Map Editor Guide for Building 2D Levels Faster
Our last platformer had 14 levels, and the first three took me longer to build than the other eleven combined. The difference was not skill.

Our last platformer had 14 levels, and the first three took me longer to build than the other eleven combined. The difference was not skill. Halfway through, I stopped placing tiles one by one inside the engine and moved the layout work to the Tiled map editor, a free program that does one job and does it very well.
If you are building a 2D game with a grid, whether it is a top down adventure, a puzzle game or a side scroller, Tiled can save you hours per level. This guide covers how I set it up, the features that matter for a small project, how it connects to different engines, and the mistakes I made so you can skip them.
What the Tiled Map Editor Actually Does
Tiled is a free, open source level editor for maps built from tiles. You load a tileset image, which is a single picture split into squares, and then paint those squares onto a grid. It runs on Windows, macOS and Linux, and it saves maps as TMX or JSON files that many engines and frameworks can read.
It supports orthogonal grids, which is the standard square layout, plus isometric and hexagonal maps. For most first projects, orthogonal is all you need.
The important point is that Tiled is not a game engine. It does not run your game, handle physics or play sounds. It only builds the map. That narrow focus is exactly why it is fast.
Setting Up Your First Map in Ten Minutes
The setup screen asks a few questions that are hard to change later, so answer them carefully.
- Choose your tile size. I use 16 by 16 pixels for pixel art and 32 by 32 for slightly more detailed art.
- Set the map size in tiles, not pixels. A 40 by 23 map at 16 pixel tiles fits a 640 by 368 view with a little room to scroll.
- Create a new tileset from your image and make sure the tile width and height match the map.
- Save the tileset as its own file so several maps can share it.
That last step matters. If each map embeds its own copy of the tileset, changing one tile means fixing every level by hand. On our platformer, a shared tileset let me recolour the ground tiles for a winter world in one evening instead of reopening all 14 maps.
Layers That Keep a Level Organised
Layers are where Tiled starts to pay for itself. A typical level of ours uses four.
| Layer | Type | What goes on it |
|---|---|---|
| Background | Tile layer | Sky, distant hills, decoration with no collision |
| Ground | Tile layer | Floors and walls the player can touch |
| Details | Tile layer | Grass, signs and props drawn over the ground |
| Objects | Object layer | Spawn points, enemies, coins, doors |
Keeping collision tiles on their own layer means your code only checks one layer for walls. When a tester says a ledge feels wrong, you know exactly where to look.
Custom Properties Instead of Hard Coded Values
Every tile and object in Tiled can carry custom properties. I give each enemy object a speed and a patrol distance, and each door a target level name. My code reads those values when it loads the map.
The result is that tuning a level no longer means editing scripts. If the third enemy in level five is too fast, I change one number in Tiled, save and test. This also helps if you are working with a friend who designs levels but does not write code. They can tune the difficulty curve without touching a single script, which ties nicely into the ideas in designing your first game level.
Getting Maps Into Your Engine
How you load a Tiled map depends on what you are building with. Some tools read Tiled files directly, while others need a plugin or a small importer.
- Phaser loads Tiled JSON maps natively.
- Godot has its own tilemap editor, but community importers can bring in Tiled maps if you prefer the Tiled workflow.
- Unity works with Tiled through community importers such as SuperTiled2Unity.
- LOVE users often rely on the Simple Tiled Implementation library.
- Scratch cannot read Tiled files, but you can export a finished layout as a PNG image and use it as a backdrop or a costume.
If you have not picked an engine yet, check how each one handles tilemaps before you commit. We compare a few options in choosing a game engine for your first solo project.
Why a Huge Tileset Slows You Down
A lot of beginner guides tell you to grab the largest asset pack you can find so you never run out of tiles. I think that advice costs more than it saves. With 2,000 tiles in the palette, you spend more time hunting for the right corner piece than building the level.
For our platformer I limited myself to about 60 tiles: ground, edges, corners, a few platforms and some decoration. Levels came together faster and looked more consistent, because every map used the same small vocabulary. You can always add tiles once you know what is missing.
The same goes for advanced features. Automapping and terrain sets, which place matching edges for you, are useful, but learn them after your second or third map, not on day one. Painting by hand first teaches you how your tileset fits together.
Mistakes That Cost Me a Week
A few habits caused most of my Tiled problems, and each is easy to avoid.
- Moving the tileset image to a new folder after making maps, which breaks the file path.
- Mixing tile sizes on one map, which makes collision boxes misalign.
- Forgetting to save the tileset after editing a property, so the change never reached the engine.
- Leaving map files out of backups. Keep them in the same project folder as your code.
Tiled Map Editor FAQ
Is the Tiled map editor really free?
Yes. Tiled is open source and free to download and use, including for commercial games. The developer accepts donations, but nothing is locked behind a payment.
Do I need Tiled if my engine has its own tilemap tool?
Not always. If the built in editor feels comfortable, stay with it. Tiled is most helpful when you want to reuse maps across engines, edit levels outside the engine or tune many object properties quickly.
Can Tiled handle large maps?
It handles big maps well, and it also supports infinite maps that grow as you paint. For performance in the game itself, split very large worlds into several smaller maps.
The Takeaway
Start with a small tileset, a fixed tile size and four clear layers, and put enemy and door settings into custom properties. Build two maps by hand before trying automation. That setup turned level building from our slowest task into one of the most enjoyable parts of the project. For more free software we rely on, browse our game development tools section.
More in Tools
Tools
Running Godot 4 on a Low Spec School Laptop Without Lag
Nine of the fourteen laptops in the Tuesday class I teach are the same kind of machine: a four or five year old 14 inch model,...
Tools
Devlog GIF Capture Tools and How to Shrink the Files
The best clip we ever recorded was six seconds of a boss slamming into a wall and dropping its shield, and almost nobody saw it...
Tools
Using butler to Upload itch.io Builds in One Command
We shipped a jam game last spring and then spent two days patching it.