PBIP and Git

Saving reports and models as text files (PBIP, TMDL, PBIR) so changes can be reviewed in Git.

A .pbix file is a black box: you cannot see what changed, review it or undo one part of it. Saving as a Power BI Project turns it into text files, and that is what lets Power BI be built like software.

Part of the Run and govern layer of the ecosystem. Reviewed 13 November 2026 by Piyush Jain.

What PBIP and Git is

A Power BI Project (PBIP) saves a report and its semantic model as a folder of text files instead of one .pbix. The model is stored in TMDL, a readable format where each table and measure is its own file. The report is stored in PBIR, one file per page and visual.

Because they are text, the files can live in Git. Fabric's Git integration connects a workspace to a branch in Azure DevOps or GitHub, so changes are committed, reviewed in a pull request and synced back to the workspace.

When to use it

Use it when

  • More than one person changes the same model or report.
  • You need to know who changed a measure, when and why, or roll back one change.
  • You want automated checks to block a broken model before it reaches users.

Think twice when

  • A one-person, one-report setup with no audit needs. It still helps, but it is not urgent.

The mistakes I see most

From opening other people's models. Each one is fixable.

  1. 1

    Committing .pbix files to Git

    Git stores them, but every change is an unreadable binary blob. Convert to PBIP first, otherwise you have backup, not version control.

  2. 2

    Git without reviews

    Pushing straight to main gives you history, not safety. The value comes from a pull request that someone, or an automated check, reviews before it merges.

  3. 3

    Editing in the service and in Git at once

    Changes made in the workspace and in a branch at the same time end in conflicts. Agree one direction of flow: build in Desktop, commit, review, sync.

Questions people ask

What is the difference between PBIX and PBIP?
PBIX is a single binary file. PBIP saves the same report and model as a folder of text files (TMDL for the model, PBIR for the report), which can be compared, reviewed and merged in Git.
What is TMDL?
Tabular Model Definition Language: a readable text format for semantic models, with each table, measure and role in its own file. It makes model changes easy to review.
Can I connect a Power BI workspace to GitHub?
Yes. Fabric Git integration supports Azure DevOps and GitHub, and syncs a workspace with a branch.

Sources: Microsoft Learn: Power BI Desktop projects (PBIP); Microsoft Learn: Fabric Git integration. Opinions are my own.