The Power BI Enhanced Report Format (PBIR) represents a major leap forward – empowering developers and teams to integrate source control, CI/CD, and collaborative development while enabling AI agents and scripts to programmatically create, edit, and manage Power BI reports in a fully supported way. Refer to the PBIR documentation to learn more.
Since its initial release, conversion to PBIR has been optional and available only through Power BI Desktop. Beginning January 2026, all new reports created in both Power BI Service and Desktop will use the PBIR format by default, and existing reports will be automatically converted to PBIR when edited and saved.
If you prefer to keep using the PBIR-Legacy report format during the preview, you can opt out.
- In Power BI Desktop, disable the Preview Features.
- Store reports using enhanced metadata format (PBIR) and Store PBIX reports using enhanced metadata format (PBIR).
- In Service, disable the new Admin Tenant Setting.
- Automatically convert and store reports in the Power BI enhanced metadata format (PBIR). The tenant setting is available now but won’t take effect until January 2026.
When PBIR reaches General Availability (GA), it will become the only supported report format. All reports will automatically convert to the PBIR format, and PBIR-Legacy will no longer be supported. We recommend preparing for this migration ahead of GA.
Defaulting to PBIR is an important milestone for General Availability of the broader Power BI Project (PBIP) file format. PBIP is built around a key principle: providing code-friendly file formats, something not possible with PBIR-Legacy. General Availability for PBIP is planned for 2026.
What about PBIX files?
PBIX files are – and will remain – the primary file format for Power BI developers. For PBIX users, this upgrade will be completely silent, with no impact on their experience. However, this change affects how the Power BI report is stored inside the PBIX. Instead of using the PBIR-Legacy format, PBIX will use the PBIR format, bringing full parity between PBIX and PBIP file structures for report metadata.