---
title: "Feature: #88742 - Import Yaml files relative to the current yaml file"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:feature-88742"
source: "Changelog/10.1/Feature-88742-ImportYamlFilesRelativeToTheCurrentYamlFile.rst"
modified: "2026-09-15T10:46:36+00:00"
---

# Feature: #88742 - Import Yaml files relative to the current yaml file

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

## Description

The configuration language YAML (Yet Another Markup Language) is used to configure rich-text editor
configuration, Form Framework form definitions, and site handling configuration files.

TYPO3's internal YAML loader has a special handling for cascading and including other YAML files
into the loaded resource via the following syntax:

```yaml
imports:
  - { resource: "EXT:rte_ckeditor/Configuration/RTE/Processing.yaml" }

another:
  option: true
```

However, the reference to the file was usually handled by referencing other resources in
extensions as in `EXT:my_extension/Configuration/MyConfig.yaml`.

This is now optimized to allow imported resources to include files relative
to the current YAML file:

```yaml
imports:
  - { resource: "misc/my_options.yaml" }
  - { resource: "../path/to/something/within/the/project-folder/generic.yaml" }

another:
  option: true
```

## Impact

Especially when using advanced site handling with multiple sites and similar configuration, it is now
possible to have one base configuration file that is referenced by the specific site configuration files
allowing to keep common config in a single place.