Text Panel Icon Updates & Improved Canvas Snapping

1. Purpose & Scope

This article documents two Builder 2.0 quality-of-life improvements shipped in Tiled v57.0.0: updated icons in the Text panel for line-height and letter-spacing controls (TD-6102), and improved canvas snapping behavior for more predictable tile alignment feedback (TD-6104).

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

2. Feature 1: Text Panel Icon Updates (TD-6102)

The icons representing the line-height and letter-spacing properties in the Builder 2.0 Text panel have been refined. The previous icons were ambiguous — users frequently confused one for the other, or could not identify what property they controlled without hovering for a tooltip.

Line Height Icon	Updated to a clearer visual representation of vertical spacing between text lines. The new icon uses a set of horizontal lines with a vertical spacing indicator, making the line-height concept immediately recognizable.
Letter Spacing Icon	Updated to represent horizontal spacing between individual characters. The new icon shows characters with a visible gap indicator between them, clearly differentiating it from line-height.
Tooltips	Both controls retain their existing tooltips. The updated icons reduce reliance on hovering to identify the control, improving discoverability for new users.

Note: No functional changes were made to the line-height or letter-spacing controls. Only the icon assets were updated. Existing microapp configurations are unaffected.

3. Feature 2: Improved Canvas Snapping (TD-6104)

Canvas snapping in Builder 2.0 has been improved to provide more predictable and useful alignment feedback when arranging tiles. The snapping system now more reliably detects edge-to-edge, center-to-center, and grid alignment opportunities and surfaces visual guides at the correct positions.

Edge Snapping	Tiles now snap to the edges of adjacent tiles and the canvas boundary more consistently, with snap guides appearing at the correct edge position.
Center Alignment	Center-to-center snap guides for horizontal and vertical alignment are now reliably triggered when a tile's center approaches another tile's or the canvas's center axis.
Snap Threshold	The snap threshold (the distance at which snapping activates) has been tuned to reduce false positives — tiles no longer snap when they are not meaningfully close to an alignment target.
Guide Visibility	Snap guide lines are now consistently visible during the drag operation and disappear cleanly on drop, without visual artifacts.

4. QA Validation

QA Scope: Snapping behavior was included in the v57.0.0 Builder 2.0 regression pass. Tested across tile types, canvas zoom levels, and grid configurations.

5. Change History

v1.0 — February 4, 2026

Initial article. Both features shipped in Tiled v57.0.0 (TD-6102, TD-6104).

Text Panel Icon Updates & Improved Canvas Snapping

Refined Builder 2.0 text property icons and more predictable tile alignment feedback