![logo-horizontal_w.png]](https://support.tiled.co/hs-fs/hubfs/logo-horizontal_w.png?height=30&name=logo-horizontal_w.png){kind=logo}
Nested Scroll Tile Returns
Nested scroll functionality reintroduced to enable layered scrolling compositions for richer interactive layouts
This article documents the return of Nested Scroll Tile functionality in Tiled v52.0.0. A scroll tile placed inside another scroll tile creates a layered scrolling composition where each container scrolls independently within its own boundary.
Scope: All Tiled users with Builder 2.0 access (Editor and above) building complex multi-axis scroll layouts.
2. Feature Description
|
Independent Scroll Axes |
Inner and outer scroll containers can have different directions (e.g., outer vertical, inner horizontal). Each axis is controlled independently by the viewer. |
|
Layered Compositions |
Enables design patterns like: a horizontal product carousel within a vertical narrative page; a fixed sidebar with independently scrolling content panels; multi-panel dashboards with independent data sections. |
|
Builder 2.0 Only |
Nested Scroll Tile is a Builder 2.0 feature. Builder 1.0 nested scroll behavior is not affected. |
|
Scroll Direction Fix |
The horizontal automatic direction detection fix (Bug Fix Bulletin KB-v52-04) ships in the same release and is a prerequisite for reliable nested scroll behavior in complex multi-axis layouts. |
3. Continuity with Adjacent Releases
|
v52.0.0 (Aug 2025) |
Nested Scroll Tile returns. Horizontal detection restored. Initial stability validated. |
|
v53.0.0 (Sep 2025) — KB-v53-03 |
Scroll undo UI fix (Done editing hidden by undo). Nested background isolation fix (drag assigns background to wrong container). |
|
v58.0.0 (Mar 2026) — KB-v58-01 |
Scroll States MVP including nested state support, import/export, and migration paths. |
4. QA Validation
|
QA Scope: Scroll Tile orientation (horizontal detection, nested layouts) was included in the August 2025 QA regression sweep. References: 2025-08-12 standup; 2025-08-07 standup (hotfix environment checks; viewer and bug fix validation). |
5. Reconciliation Note
|
Deferred: Jira ticket number pending reconciliation. Update per the checklist in KB-v52-06. |
6. Change History
|
v1.0 — August 12, 2025 |
Initial article. Feature shipped in Tiled v52.0.0. Ticket number pending reconciliation. |