Skip to main content

Documentation Index

Fetch the complete documentation index at: https://backstage.spotify.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Portal is continuously evolving with new features, improvements, and fixes. This changelog provides a comprehensive history of all updates to help you stay informed about the latest enhancements and changes to your Portal experience.

​
3 March, 2026

Scaffolder: Create and manage Software Templates entirely in Portal scaffolder v1.46.0-portal.0 Software Templates can now be created, edited, published, and run entirely inside Portal — no more switching to YAML in source control to manage templates.
  • Template authoring — Create from scratch, upload existing templates, or start from examples, with a full in-Portal code editor, validation, linting, and live form preview - Action & field discovery — Browse installed actions and form fields with inputs, outputs, and example usage - Execution visibility — Dry runs with step-level status and logs, execution history, and clear output artifacts - Publishing — Publish directly from Portal with commit-to-source-control and catalog registration

​
8 December, 2025

Catalog Builder with Managed by Portal V2 admin v1.45.2-portal.4 Catalog Builder is now available with Managed by Portal V2, providing enhanced catalog management capabilities.
AiKA - Fixed footnote references breaking URLs - Added telemetry and logging support - Added log semantics support

​
27 November, 2025

Portal upgraded to Backstage 1.45.2 admin v1.45.2-portal.0 Portal has been upgraded to Backstage version 1.45.2, bringing the latest upstream improvements and compatibility updates.

​
27 November, 2025

AiKA: Export conversations and search history aika v1.45.2-portal.0 You can now export AiKA conversations, including validation data, to simplify debugging and sharing issues. Search history has also been added so you can quickly revisit previous queries.
Soundcheck
  • Fixed an issue where not defining the SonarQube instance name properly could cause the config to be continuously reset
  • BullMQ custom Job IDs now use dots instead of colons, aligning with the latest validation rules
  • Fixed an issue where the number of applicable tracks and campaigns on the Tech Insights status tile did not match the actual table count
  • Fixed an issue where SCM YAML facts were not displayed in the Integration No-Code UI
  • Improved efficiency of entity reference retrieval from catalog
  • Updated integrations’ logos
AiKA
  • Improved chat resilience so messages are preserved when MCP servers change
  • Truncated tool results and verbose MCP logging for cleaner output
  • Refactored backend configuration internals for improved maintainability

​
22 October, 2025

Soundcheck: Tech Insights is now your default landing page soundcheck v1.44.1-portal.1 Tech Insights is now your default landing page, delivering faster performance, streamlined navigation, and actionable insights front and center.
  • Redesigned group hierarchy filter and improved owner filter search by name, title, and description - Fixed a stability issue if the remote configuration of checks, tracks, or SCM integration is invalid - Fixed an issue where the collectors page would error if there are incorrectly formatted values - Fixed an issue where a check’s rule path was missing in the UI when using a non-default path resolver - Resolved an issue where the “Cannot edit check” warning would occasionally appear after updating a check
  • Performance improvements and GQL efficiency updates

​
10 October, 2025

Database connection method updated for new infrastructure admin v1.43.3-portal.3 The database connection method has been updated to comply with new infrastructure requirements.

​
8 October, 2025

Data Experience: Cards moved to Dataset Entity Overview tab data-experience v1.43.3-portal.2 Data Experience cards for dataset details and schema are now on the Dataset Entity Overview tab. The separate Data Experience tab has been removed.
Soundcheck - Improved performance by updating the default schedules for the applicableEntitiesRefresh and groupHierarchyRefresh cache jobs

​
24 September, 2025

Soundcheck: Tech Insights page for tracking software quality metrics soundcheck v1.43.2-portal.2 Soundcheck now includes a Tech Insights page providing analytics for tracking software quality metrics across your organization. See the Tech Insights documentation for more details.
  • Added total track/campaign count to distinguish from applicable ones on the tech insights page - Added manual option to recertify a track. See Updating certification history
  • Added a new canned Soundcheck check for Data Experience - Added a filter by status for the entities table on the Campaign insights page - Added support for personal access token (bearer token) authentication in Jira integration. See Jira prerequisites
  • Added support for issues-count Jira fact that returns a number of issues matching JQL. See Collecting issues-count fact
  • Fixed owners filter to support name, title, description on the Check & Track creation pages - Updated track entities API to support a certification status filter and return level information
  • The config option soundcheck.remote_file_updates has been deprecated in favor of soundcheck.remoteFileUpdates. You can continue to use the old option for now, but it will be removed in a future release. - The config option soundcheck.programs has been deprecated in favor of soundcheck.tracks. You can continue to use the old option for now, but it will be removed in a future release. - Jira’s Search for issues using JQL API was deprecated and removed for Jira Cloud instances. Soundcheck will now fetch issue-search fact data from Jira’s Search for issues using JQL enhanced search API for Jira Cloud instances. - Updating track filters or levels through the UI will automatically regenerate track certification history for up to 365 days
  • Fixed Check Insights Page History when Status Filters are applied - Fixed issue where conditional permissions were incorrectly hiding or showing the edit button - Fixed issue where fetching checks would return all checks even if check IDs were passed in to filter - Fixed issue when using the default issues-search name for the Jira fact name, the Jira fact collection fails to execute

​
22 July, 2025

Soundcheck: New landing page placeholder soundcheck v1.41.1-portal.1 The Soundcheck link on the left-hand navigation bar now links to a placeholder landing page instead of the overview page. This placeholder will be replaced with a more fully realized landing page in a future release.

​
16 July, 2025

Entity Overlays is now GA admin rbac v1.40.2-portal.2 Entity Overlays is now generally available. If using a non-default RBAC policy, you must adjust your policy to incorporate entity overlays permissions.

​
9 July, 2025

Portal upgraded to Backstage 1.40.2 admin v1.40.2-portal.0 Portal has been upgraded to Backstage version 1.40.2.

​
26 June, 2025

Soundcheck: Fact-collectors hotfix soundcheck v1.40.1-portal.1 A hotfix was deployed to resolve an issue preventing Portal customers from using certain Soundcheck fact-collectors/integrations. All impacted collectors have been patched and are now fully configurable and available for use within Portal.

​
24 June, 2025

Navigation: Create new component moved to top of sidebar admin v1.40.1-portal.0 The “Create new component” sidebar item has been moved to the top to improve UI experience and findability.
General
  • Added AzureDevOps Module for Soundcheck
Fixes
  • Catalog now renders without errors for ArgoCD plugin
  • Scaffolder progress bar is now updated in real time as steps are executed
  • UI/UX fixes when a license key errors out
  • Minor UI improvements and responsiveness fixes for the onboarding wizard

​
11 June, 2025

Soundcheck: No-Code UI Extensions and Exemptions Tab soundcheck v1.39.0-portal.6 You can now extend the Soundcheck Integrations UI with custom no-code interfaces (supported with the new frontend system only). A brand-new Exemptions tab lets you view exempt entities and their justifications directly in Check Insights.
  • See which checks depend on a collector for more transparency in your dependencies - Integration cards now show whether they’re UI-configured - Filter by exempt entities on the overview page

​
2 June, 2025

Improved Catalog page design admin v1.39.0-portal.3 The Catalog page design has been improved for better usability.
Soundcheck - Enabled GitLab Soundcheck integration

​
26 May, 2025

Enhanced Portal Navigation and new landing page admin v1.39.0-portal.0 Portal navigation has been enhanced with streamlined access to subpages and admin pages, a collapsible sidebar, and quick user settings access. A new default landing page provides direct access to Search and quick links to your most recent and frequently visited pages.

​
13 May, 2025

Soundcheck: Security hotfix for sensitive data exposure soundcheck v1.38.1-portal.4 Critical security enhancements have been applied to Soundcheck to address sensitive data exposure in GitHub-related facts.
  • Redacted sensitive collector secrets in GraphQL queries to prevent exposure - Addressed overexposure of GitHub facts on the frontend by redacting sensitive fact types including Code Scanning Alerts, Dependabot Alerts, and Secret Scanning Alerts

​
1 May, 2025

Portal upgraded to Backstage 1.38.1 with real-time catalog updates admin v1.38.1-portal.2 Portal has been upgraded to Backstage v1.38.1. You can now enable real-time catalog updates via GitHub webhooks.
  • Fixed template editor and logs in Scaffolder not showing

​
15 April, 2025

GitLab support via config manager admin v1.37.1-portal.2 GitLab is now supported via the config manager.
  • RBAC and Insights nav items moved to main navigation - Config manager logs can now be filtered by log level
  • Fixed preview discard bug in extension manager

​
7 April, 2025

Setup Wizard now supports GitHub App for authentication admin v1.37.1-portal.0 The Setup Wizard now supports using GitHub App for authentication.

​
3 April, 2025

Entity overview layout is now customizable by Portal admins admin v1.37.0-portal.2 Portal admins can now edit the layout of the Entity overview tab for all users. Entity cards can be resized and re-ordered. Access the layout editor via the entity context menu.

​
27 March, 2025

Soundcheck: New GitHub Integration fact types soundcheck v1.37.0-portal.0 Added additional fact types to the GitHub Integration.
  • Code Scanning Alerts - Dependabot Alerts - Secret Scanning Alerts - Security Advisories

​
19 March, 2025

Onboarding UI supports GitHub Apps and personal access tokens admin v1.36.1-portal.5 The onboarding UI has been adjusted to support both GitHub Apps and GitHub personal access tokens.
General
  • Added N/A option to reset the select value in config manager
Fixes
  • Fixed started plugin not showing as started
  • Made org selection required for GitHub App users
  • Fixed Jira Dashboard plugin not being removed from the Promoted section when installed

​
10 March, 2025

Skill Exchange configuration enabled skill-exchange v1.36.1-portal.3 Additional configuration for Skill Exchange has been enabled.

​
5 March, 2025

Portal: Entra ID and Okta authentication support admin v1.36.1-portal.2 Portal now offers Entra ID and Okta authentication along with organizational data ingestion.
Portal
  • Portal automatically cleans up entities that belong to entity providers that are no longer configured
  • Backend plugins added to Portal are now allowed to fail on startup without impacting core Portal features
  • Soundcheck is now visible on the Catalog entity page for more kinds
Soundcheck
  • Added support for specifying a group filter in the configuration to filter groups relevant to Soundcheck
  • Enhanced the date operator for creating checks, allowing input values like -P1Y
  • Added support for exclusion filters - you can now exclude specific entities from a check
  • Soundcheck now supports HTTP Third-Party Integration, configurable via YAML and the UI
  • Azure DevOps collector is now configurable within the UI
  • The Catalog collector can be configured through YAML and UI
  • Added support for label and annotation filters in the UI
  • Soundcheck now records resolved values and rule evaluation details for improved transparency
For further details, see the Spotify Plugins for Backstage release notes.
  • Fixed bug when using dots as keys in the config manager - Fixed pagination in config manager history

​
26 February, 2025

RBAC: View and manage permissions in Portal rbac v1.36.1-portal.0 You can now view and manage permissions in Portal using RBAC.
General
  • Improved error messages when faulty config is submitted
Soundcheck
  • Added BigQuery, New Relic, and HTTP Soundcheck integrations

​
17 February, 2025

Config Manager UX improvements and troubleshooting logs admin v1.35.1-portal.2 The Config Manager UX has been simplified by hiding unnecessary configurations. Portal troubleshooting logs view has been added to the config manager.
  • Improved Config History performance with pagination - “Check Insights” now supports filtering by system, type, owner, and lifecycle
  • Fixed jenkins plugin and sonarqube plugin issues on startup - Improved UI of docs links