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
- 1
Receive the marketplace visual update
Power BI loads the published Ataytis Vega Studio package through its visual distribution process.
- 2
Open an existing report copy
Retain the original PBIX while validating the updated visual against representative report pages.
- 3
Review version messages
Read any Studio or provider-version context displayed for the specification when the report opens.
- 4
Validate the visual
Work through the compatibility checks below in both Power BI Desktop and the Service.
- 5
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.