---
title: "Basic concepts"
manual: "TYPO3 Explained"
version: "11.5"
permalink: "https://docs.typo3.org/permalink/t3coreapi:fal-concepts@11.5"
source: "ApiOverview/Fal/Concepts/Index.rst"
rendered: "2026-10-21T15:30:00+00:00"
---

> [!WARNING]
> **Attention**
>
> TYPO3 v11 has reached end-of-life as of October 31th 2024 and
> is no longer being maintained. Use the version switcher on the top
> left of this page to select documentation for a supported version of TYPO3.
>
> Need more time before upgrading?
> You can purchase Extended Long Term Support (ELTS) for TYPO3 v11 here:
> [TYPO3 ELTS](https://typo3.com/services/extended-support-elts).

# Basic concepts {#fal-concepts}

This chapter presents the general concepts underlying the TYPO3
file abstraction layer (FAL). The whole point of FAL - as its name
implies - is to provide information about files abstracted with
regards to their actual nature and storage.

Information about files is stored inside database tables and
using a given file is mostly about creating a database relation
to the record representing that file.

## Storages and drivers {#fal-concepts-storages-drivers}

Every file belongs to a storage, which is a very general concept
encompassing any kind of place where a file can be stored: a local
file system, a remote server or a cloud-based resource. Accessing
these different places requires an appropriate driver.

Each storage relies on a driver to provide the user with the
ability to use and manipulate the files that exist in the storage.
By default, TYPO3 provides only a local file system driver.

A new TYPO3 installation comes with a predefined storage,
using the local file system driver and pointing to the
`fileadmin/` directory, located in your public folder.
If it is missing or offline after installation, you can create it yourself.

## Files and metadata {#fal-concepts-files-metadata}

For each available file in all present storages, there exists a
corresponding database record in the table `sys_file`, which
contains basic information about the file (name, path, size, etc.),
and an additional record in the table `sys_file_metadata`, designed
to hold a large variety of additional information about the file
(metadata such as title, description, width, height, etc.).

> [!TIP]
> Although FAL is part of the TYPO3 Core, there is a
> system extension called [filemetadata](https://packagist.org/packages/typo3/cms-filemetadata), which is not installed
> by default. It extends the `sys_file_metadata` table with
> fields such as copyright notice, author name, location, etc.

## File references {#fal-concepts-file-references}

Whenever a file is used - for example, an image attached to a
content element - a reference is created in the database
between the file and the content element. This reference can
hold additional information like an alternative title to
use for this file just for this reference.

This central reference table (`sys_file_reference`) makes
it easy to track every place where a file is used inside a
TYPO3 installation.

All these elements are explored in greater depth in the chapter
about [FAL components](https://docs.typo3.org/permalink/t3coreapi:fal-architecture-components@11.5).