---
title: "Deprecation: #92132 - Shortcut PHP API"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:deprecation-92132-1668719172"
source: "Changelog/11.0/Deprecation-92132-DeprecatedShortcutPHPAPI.rst"
typo3-version: "11.0"
typo3-major: 11
type: "deprecation"
issue: 92132
forge: "https://forge.typo3.org/issues/92132"
tags: ["Backend", "PHP-API", "FullyScanned", "ext:backend"]
rendered: "2026-10-03T08:19:36+00:00"
---

# Deprecation: #92132 - Shortcut PHP API {#deprecation-92132-1668719172}

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

## Description {#description}

Some methods related to shortcut / bookmark handling in TYPO3 Backend have been marked as deprecated:

-   `\TYPO3\CMS\Backend\Template\ModuleTemplate->makeShortcutIcon()`
-   `\TYPO3\CMS\Backend\Template\ModuleTemplate->makeShortcutUrl()`
-   `\TYPO3\CMS\Backend\Template\Components\Buttons\Action\ShortcutButton->getSetVariables()`
-   `\TYPO3\CMS\Backend\Template\Components\Buttons\Action\ShortcutButton->getGetVariables()`
-   `\TYPO3\CMS\Backend\Template\Components\Buttons\Action\ShortcutButton->setGetVariables()`
-   `\TYPO3\CMS\Backend\Template\Components\Buttons\Action\ShortcutButton->setSetVariables()`

See also:

-   [Deprecation: #93060 - Shortcut title must be set by controllers](https://docs.typo3.org/permalink/changelog:changelog-deprecation-93060-shortcuttitlemustbesetbycontrollers)
-   [Deprecation: #93093 - MethodName in Shortcut PHP API](https://docs.typo3.org/permalink/changelog:changelog-deprecation-93093-deprecatemethodnameinshortcutphpapi)

## Impact {#impact}

Using those methods directly or indirectly will trigger PHP `E_USER_DEPRECATED` errors.

## Affected Installations {#affected-installations}

Extensions with backend modules that show the shortcut button in the doc header may
be affected. The extension scanner will find all PHP usages as weak match.

## Migration {#migration}

The new method `\TYPO3\CMS\Backend\Template\Components\Buttons\Action\ShortcutButton->setArguments()` has been
introduced. This method expects the full set of arguments and values to create a shortcut to a specific view, example:

```php
$buttonBar = $this->moduleTemplate->getDocHeaderComponent()->getButtonBar();
$pageId = (int)($request->getQueryParams()['id'] ?? 0);
$shortCutButton = $buttonBar->makeShortcutButton()
    ->setRouteIdentifier('page_preview')
    ->setDisplayName('View page ' . $pageId)
    ->setArguments([
       'id' => $pageId,
    ]);
$buttonBar->addButton($shortCutButton, ButtonBar::BUTTON_POSITION_RIGHT);
```