RATATOSKRATATOSK
Sign in

Backstage

v1.48.0CI/CD & App Delivery
Feb 17, 2026

CHECK 7PLAN 2OTHER 15

Backstage v1.48.0 combines breaking API and configuration changes with new frontend and catalog capabilities. Plugin authors and operators are most affected by compatibility changes around catalog extensions, API overrides, removed settings, and frontend extension points, while CLI-built apps now enable module federation by default.

Check if affected (7)

  • breakingStable catalog extension point exports

    Applies if you provide custom processors or entity providers to the catalog.

    The catalogProcessingExtensionPoint export has moved from @backstage/plugin-catalog-node/alpha to the regular stable exports. Other catalog extension points have also graduated from alpha, though not all of them have.

  • breakingRejected API overrides

    Applies if you use API overrides for CatalogApi or ErrorApi.

    API overrides for CatalogApi and ErrorApi are now rejected with an error instead of producing a warning.

  • breakingRemoved auth.experimentalDynamicClientRegistration.tokenExpiration

    Applies if you use auth.experimentalDynamicClientRegistration.tokenExpiration.

    The auth.experimentalDynamicClientRegistration.tokenExpiration configuration option has been removed in favor of the new method described in the release.

  • breakingRemoved summary from EntityCardBlueprint

    Applies if you use the summary type in EntityCardBlueprint.

    The summary type has been removed from EntityCardBlueprint.

  • breakingRemoved multiple extension point support

    Applies if you use multiple extension points.

    Support for multiple extension points has been removed.

  • breakingModule federation enabled by default

    Applies if you build an app with @backstage/cli.

    Apps built with @backstage/cli now have module federation enabled by default without additional overhead.

  • breakingRemoved EXPERIMENTAL_MODULE_FEDERATION flag

    Applies if you use the EXPERIMENTAL_MODULE_FEDERATION flag.

    The EXPERIMENTAL_MODULE_FEDERATION flag has been removed.

Plan ahead (2)

  • deprecatedIconComponent type deprecation

    Applies if your code uses the IconComponent type.

    The IconComponent type is deprecated and replaced by the element-based IconElement type.

  • deprecateditems prop deprecation

    Applies if your code uses the items prop.

    The items prop is deprecated in favor of the new navItems prop.

All 15 other recorded changesadditions 13 · constraints 1 · value changes 1

additions (13)

  • This can be enabled in the auth-backend plugin by using the auth.experimentalClientIdMetadataDocuments.enabled flag in config.
  • Clients can now request the offline_access scope to receive refresh tokens when auth.experimentalRefreshToken.enabled is set
  • Both @backstage/frontend-test-utils and @backstage/backend-test-utils now export utilities for creating service and API mocks, createServiceMock and createApiMock.
  • Plugins now have optional titles and icons in the new frontend system.
  • This comes in the form of an updated PageBlueprint that now supports sub-page navigation using a new SubPageBlueprint.
  • This also introduces the new plugin-wide PluginHeader
  • Added support for the New Frontend system to the Home plugin.
  • Extracted predicate types from @backstage/plugin-catalog-react/alpha into a standalone package for general reuse.
  • New Alert component with support for status variants, icons, loading states, and custom actions.
  • New FullPage component that fills the remaining viewport height below the PluginHeader.
  • Added a destructive prop to the Button component for dangerous actions like delete or remove, working with all button variants.
  • The useTable hook now accepts a direct data prop for mode "complete" instead of requiring getData()
  • There’s a new experimental catalogScmEventsServiceRef in town.

constraints (1)

  • Added connection.type: azure in the database client config for Microsoft Entra authentication with Azure Database for PostgreSQL.

value changes (1)

  • The testing utilities for the new frontend system have gotten an overhaul in this release, with all new features documented in the [plugin testing section](https://backstage.io/docs/frontend-system/building-plugins/testing).
Add Backstage to your stack

A weekly email arrives when a release needs action. Like the breaking changes in this release.

Add to stack →
Official release note ↗All Backstage releases →