---
title: "Deprecation: #94741 - Register SoftReference parsers via DI"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:deprecation-94741"
source: "Changelog/11.4/Deprecation-94741-RegisterSoftReferenceParsersViaDI.rst"
modified: "2026-09-14T09:47:36+00:00"
---

# Deprecation: #94741 - Register SoftReference parsers via DI

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

## Description

The former way of registering soft reference parsers in the global array
`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['GLOBAL']['softRefParser']`
has been marked as deprecated.

## Impact

Registering soft reference parsers in the global array will trigger a PHP `E_USER_DEPRECATED` error.

## Affected Installations

All installations, that register user-defined soft reference parsers in the
global array
`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['GLOBAL']['softRefParser']`.

## Migration

Use the new way of registering soft reference parsers by dependency injection
in the corresponding `Configuration/Services.(yaml|php)` file of your extension.

Before:

```php
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['GLOBAL']['softRefParser']['your_key'] = \VENDOR\Extension\SoftReference\YourSoftReferenceParser::class;
```

After:

```yaml
VENDOR\Extension\SoftReference\YourSoftReferenceParser:
  tags:
    - name: softreference.parser
      parserKey: your_key
```

> [!NOTE]
> If a parser is registered in both ways with the same key, the registration
> in the global array takes precedence to ensure backwards-compatibility.
>
> To ensure compatibility with TYPO3 v10-v12, it is recommended to register
> both places at the same time.

## Related

-   [RegisterSoftReferenceParsersViaDI (Feature)](https://docs.typo3.org/permalink/changelog:feature-94741)
-   [SoftReferenceIndex (Deprecation)](https://docs.typo3.org/permalink/changelog:deprecation-94687)