---
title: "Deprecation: #108008 - Manual shortcut button creation"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:deprecation-108008-1762896168"
source: "Changelog/14.0/Deprecation-108008-ManualShortcutButtonCreation.rst"
typo3-version: "14.0"
typo3-major: 14
type: "deprecation"
issue: 108008
forge: "https://forge.typo3.org/issues/108008"
tags: ["Backend", "PHP-API", "PartiallyScanned", "ext:backend"]
rendered: "2026-09-23T15:30:34+00:00"
---

# Deprecation: #108008 - Manual shortcut button creation {#deprecation-108008-1762896168}

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

## Description {#description}

Manually creating and adding
`\TYPO3\CMS\Backend\Template\Components\Buttons\ShortcutButton`
instances to the button bar is deprecated and will trigger a deprecation
warning.

Controllers should use the new
`\TYPO3\CMS\Backend\Template\Components\DocHeaderComponent::setShortcutContext()`
method instead, which automatically creates and positions the shortcut button.

## Impact {#impact}

Controllers that manually create and add
`\TYPO3\CMS\Backend\Template\Components\Buttons\ShortcutButton`
instances to the button bar will trigger a deprecation warning. The shortcut
button will still work as expected.

## Affected installations {#affected-installations}

Installations with custom backend modules that manually create shortcut buttons.

## Migration {#migration}

Replace manual shortcut button creation with the new API.

**Before**:

```php
$shortcutButton = $this->componentFactory->createShortcutButton()
    ->setRouteIdentifier('my_module')
    ->setDisplayName('My Module')
    ->setArguments(['id' => $pageId]);
$view->addButtonToButtonBar($shortcutButton);
```

**After**:

```php
$view->getDocHeaderComponent()->setShortcutContext(
    routeIdentifier: 'my_module',
    displayName: 'My Module',
    arguments: ['id' => $pageId]
);
```