Create a Power BI report in enhanced report format

Applies to: ✅ Power BI Desktop

The Power BI enhanced report format (PBIR) for Power BI Project files (PBIP) marks a milestone in achieving the primary goal of Power BI Desktop developer mode. It provides source-control friendly file formats to unblock codevelopment and enhance development efficiency.

Diagram of Power BI Project with TMDL and PBIR.

Power BI Projects (PBIP) support saving the report and semantic model into a folder using source-control friendly formats:

  • PBIR for the report.
  • TMDL for the semantic model.

The PBIR file format simplifies tracking changes and resolving merge conflicts. It uses properly formatted JSON and organizes each visual, page, bookmark, and so on, in separate individual files within a folder structure.

Screenshot of visual json folder structure.

You can enhance report development efficiency in one of two ways:

  • Copy and paste visuals, pages, bookmarks, or files between reports.
  • Apply manual or programmatic batch changes to the PBIR files.

Unlike PBIR-legacy format (report.json), PBIR is a publicly documented format. This format allows modifications from non-Power BI applications. Each file has a public JSON schema, which documents each property and lets code editors like Visual Studio Code perform syntax validation while editing. On open, Power BI Desktop validates the changed PBIR files to guarantee successful loading.