---
title: "Breaking: #83153 - Migrated backend_layout.icon to FAL"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:breaking-83153"
source: "Changelog/9.0/Breaking-83153-MigratedBackendLayoutIconToFileAbstractionLayer.rst"
typo3-version: "9.0"
typo3-major: 9
type: "breaking"
issue: 83153
forge: "https://forge.typo3.org/issues/83153"
tags: ["Database", "FAL", "Backend", "NotScanned"]
rendered: "2026-09-17T12:41:04+00:00"
---

# Breaking: #83153 - Migrated backend_layout.icon to FAL {#breaking-83153-migrated-backend-layout-icon-to-fal}

See [forge#83153](https://forge.typo3.org/issues/83153)

## Description {#description}

The existing database field "icon" for Backend Layouts put into the database, was previously a file upload field,
putting all icons under `uploads/media`. The field is migrated to the File Abstraction Layer (FAL), having
proper file relations like all other parts of TYPO3 core.

## Impact {#impact}

When working with the TCA for the backend_layout.icon field, sys_file_reference relations are now expected.
When querying the database table directly, icon only contains the number of references of this backend layout.

## Affected Installations {#affected-installations}

Installations with custom backend layout icons and, more specifically extensions dealing with the database
table directly.

## Migration {#migration}

An upgrade wizard in the TYPO3 install tool moves all existing icons of backend_layouts from `uploads/media` to
`fileadmin/_migrated/backend_layouts/`.

For extensions directly working on the database table, the database access needs to be modified.