Skip to content
English
Submit a request
  • There are no suggestions because the search field is empty.

Builder 2.0: Multi-Tile Alignment, Spacing & Padding

Properties panel now exposes alignment, distribution, and padding controls when multiple tiles are selected

1. Purpose & Scope

This article documents the multi-tile alignment, spacing, and padding controls introduced in Builder 2.0 as part of the Tiled v59.0.0 April release. When two or more tiles are selected simultaneously, the Properties panel now surfaces a dedicated set of controls for aligning and distributing those tiles relative to each other or the canvas.

Scope: All Tiled users with Builder 2.0 access (Editor role and above).

2. Feature Description

Selecting multiple tiles in Builder 2.0 now activates a contextual properties section in the right-hand Properties panel. This section contains three categories of controls:

Alignment

Align selected tiles to a common edge or center axis — align left, align right, align top, align bottom, center horizontally, center vertically.

Spacing (Distribution)

Distribute selected tiles with equal spacing between them — distribute horizontally or distribute vertically.

Padding

Apply uniform or per-side padding to the group of selected tiles, adjusting their internal spacing relative to each other.

3. How to Use Multi-Tile Alignment

3.1 Selecting Multiple Tiles

  1. Click the first tile on the canvas.
  2. Hold Shift and click additional tiles to add them to the selection, or drag-select to capture a group of tiles.
  3. With multiple tiles selected, the Properties panel on the right will display the Alignment, Spacing, and Padding controls.

3.2 Applying Alignment

  1.     With multiple tiles selected, locate the Alignment section in the Properties panel.
  2.     Click the desired alignment button (e.g., Align Left, Center Horizontally).
  3.     Tiles reposition on the canvas according to the selected alignment.

3.3 Applying Distribution (Spacing)

  1.     Select three or more tiles. Distribution requires at least three tiles.
  2.     Click Distribute Horizontally or Distribute Vertically.
  3.     Tiles redistribute with equal spacing between them along the selected axis.

Note: Alignment and distribution operations act on the current position of tiles on the canvas. Undo (Ctrl+Z / Cmd+Z) is supported for all alignment and distribution actions.

4. Testing Verification Steps

QA Focus: This feature is the primary testing focus for the v59.0.0 release cycle. Test all alignment directions, distribution, and padding with varying tile counts and types.
  1.     Select two tiles and verify all six alignment options (left, right, top, bottom, center horizontal, center vertical) work correctly.
  2.     Select three or more tiles and verify horizontal and vertical distribution produces equal spacing.
  3.     Select a mix of tile types (image, text, video, hotspot) and confirm alignment controls apply to all types.
  4.     Apply padding and verify the spacing adjusts as expected.
  5.     Undo an alignment action and confirm tiles return to their original positions.
  6.     Verify the Properties panel shows the alignment section only when multiple tiles are selected (single-tile selection should not show it).

5. Change History

v1.0 — April 2025

Initial article. Feature shipped in Tiled v59.0.0 April release.