Tiled 1.7 Released

This release brings a configurable “major grid”, rearranging of tiles, portable configuration and improved project security. It also fixes a crash that became visible with the crash reporting feature added in Tiled 1.6.

Major Grid and Fade Color Options

A new “major grid” option defaults to showing a stronger grid line every 10 tiles, but can be configured as desired. In addition, the color used to “fade out” background layers when the “highlight current layer” mode is enabled can now be customized.

Major Grid

Rearrange Tiles

It is now possible to change the order of the tiles in a tileset, for both “image collection” tilesets as well as tilesets based on a tileset image.

Major Grid

Rearranging the tiles does not affect their IDs and the tileset image is not modified, it only changes the display order in the tileset view. It does affect the order in which the tiles are saved in the TSX and JSON formats, so make sure your loader doesn’t depend on those tiles being sorted by their ID!

Portable Configuration

You can now place a tiled.ini file alongside the Tiled executable to activate a portable configuration mode. When Tiled detects this file, it will store its preferences there, place user data in a “data” folder alongside and load scripted extensions from an “extensions” folder in the same directory. This should allow Tiled to be carried around on a USB stick along with its configuration.

Security Enhancement

Scripted extensions shipping with projects are no longer enabled by default, except for projects you’re saving yourself. The scripting API includes the ability to read/write arbitrary files, connect to the internet and run arbitrary processes, so care should be taken before installing any extensions to make sure they can be trusted.

When opening a project that includes scripted extensions, you will now be prompted to enable those extensions:

Extensions Popup

Scripting API Documentation

The scripting API documentation is now generated by TypeDoc based on TypeScript type definitions. The type definitions are also available as the @mapeditor/tiled-api NPM package, providing code-completion while writing Tiled JavaScript extensions.


  • Added basic “major grid” option with stronger lines (with Ilya Arkhanhelsky, #3032)
  • Added ability to rearrange tiles in a tileset (with José Miguel Sánchez García, #2983)
  • Added option to choose background fade color (with SchmidtWC, #3031)
  • Added portable mode, enabled when a “tiled.ini” is detected alongside the Tiled executable (#2945)
  • Disable project extensions by default, for security reasons (#3058)
  • Render selection preview and hovered item highlight above labels (#3036)
  • Changed the donation reminder to be non-modal
  • docs: Generate scripting API documentation using TypeDoc (with Erik Schilling (#2965) and MrMasterplan (#3040, #3041, #3045))
  • QMake/Qbs: Added a way to disable DBus support (with Dmitry Marakasov, #3039)
  • Scripting: Fixed ‘mouseLeft’ callback for scripted tools (#3050)
  • Scripting: Fixed loading of icons with explicit “ext:” prefix (#3048)
  • Scripting: Made TileMap coordinate conversion functions always work (#3054)
  • tBIN plugin: Convert ‘color’, ‘object’ and ‘file’ properties on save
  • Python plugin: Added Layer.offset and Layer.setOffset (with sverx, #3073)
  • Python plugin: Linux AppImage now supports Python 3.6 instead of 3.5
  • Windows: Add a default “Open in text editor” command based on notepad.exe
  • Fixed possible crash in Properties view when switching files
  • Fixed watching/unwatching of folders when adding/removing from project (#3035)
  • Fixed determining desired file format by extension on export
  • Fixed compilation issue with GCC 10 (#3037)
  • Updated Bulgarian, Norwegian Bokmål, Portuguese (Brasil), Portuguese (Portugal), Russian, Thai and Turkish translations

Support Tiled Development :heart:

This new release was made possible by about 300 patrons and sponsors supporting me on a monthly basis as well as many people choosing to pay for Tiled on itch.io and some who donated through Liberapay. To ensure I will be able to keep developing Tiled at this pace, please set up a small monthly donation!

Your donation primarily enables me to work 3 full days/week on Tiled. With additional funds I can spend more days on Tiled. Let’s make this tool even better!


Tiled installer for Windows 10+ (64-bit) 18 MB
Version 1.7.0 Jun 04, 2021
Tiled installer for Windows 7+ (32-bit) 20 MB
Version 1.7.0 Jun 04, 2021
Tiled installer for Windows XP (32-bit) 23 MB
Version 1.7.0 Jun 04, 2021
Tiled for macOS 11+ 34 MB
Version 1.7.0 Jun 04, 2021
Tiled AppImage for Linux (64-bit) 42 MB
Version 1.7.0 Jun 04, 2021

Get Tiled Map Editor

Download NowName your own price

Leave a comment

Log in with itch.io to leave a comment.