Versions and updates
Understand Studio, Vega runtime, renderer, and Power BI host versions when updating or troubleshooting a visual.
Version layers
| Layer | What it affects |
|---|---|
| Ataytis Vega Studio build | The editor, inspector, Power BI integration, settings, and packaged runtime. |
| Vega provider version | Specification parsing, transforms, expressions, marks, signals, rendering behavior, and the schema used by the bundled runtime. |
| Power BI host version | The custom-visual host, marketplace package, data view, permissions, interactions, and Desktop or Service behavior. |
| Renderer | SVG or Canvas output and the performance or accessibility characteristics associated with that rendering mode. |
Version information in the specification
The visual records the Studio build and Vega provider version alongside the applied specification. When a report is opened after the visual has been updated, the Studio uses that record to detect a version difference and present a version-change message where relevant.
Visual update flow
Receive the marketplace visual update
Power BI loads the published Ataytis Vega Studio package through its visual distribution process.
Open an existing report copy
Retain the original PBIX while validating the updated visual against representative report pages.
Review version messages
Read any Studio or provider-version context displayed for the specification when the report opens.
Validate the visual
Work through the compatibility checks below in both Power BI Desktop and the Service.
Save the validated report
Publish the updated report state after the required checks pass.
Compatibility checks
- Diagnostics contains no new parsing errors or Vega warnings.
- The bundled Vega schema and runtime support every transform, expression, signal, and mark used by the specification.
- The Power BI-backed
datasetretains the expected field names, types, helper fields, and row shape. - SVG and Canvas output remain consistent with the renderer used by the report.
- Power BI tooltips, selection, cross-highlighting, context menus, filters, and bookmarks retain their expected behavior.
- Specifications reused from another report still parse and render against the updated bundled runtime.
- The published report matches Desktop behavior under the target workspace and audience permissions.
Version details in support reports
A version-related support report includes the Power BI Desktop or Service version, Ataytis Vega Studio version, Vega provider version when shown, renderer, and whether the same behavior occurred before the update.