Power BI project guides
Power BIHow a Power BI project (PBIP) is laid out, what to keep in Git, and what to do when Power BI Desktop will not open one.
- What is a PBIP project, and what is TMDL?A Power BI project (PBIP) saves a report and its semantic model as plain text files in folders, instead of one
.pbixfile. TMDL is a text format for the model, with a file for each table. - Power BI Desktop can't open a PBIPWhen Power BI Desktop refuses a project, the message usually names a file. Find that file below, then the page for the message.
- PBIR vs PBIR-LegacyPBIR saves a report as a folder with a file for each page, visual and bookmark. PBIR-Legacy is the older single
report.json. PBIR is now the default. - PBIP and Git: what to commit and what to ignoreA PBIP project is plain text, so Git can track it. Keep the local cache and your own settings out, and set Git up for the line endings Power BI Desktop writes.
- Rename a measure or column without breaking visualsReports connected live to a semantic model are not told about a rename. Their visuals keep the old name and show Something's wrong with one or more fields.
- Turn a .pbix into a PBIP projectPower BI Desktop converts a .pbix to a PBIP, and back, with File > Save as. Microsoft says that is the only way: there is no API or command line for it.
- Find where a measure is usedPower BI Desktop does not list the visuals that use a measure, and lineage in the service stops at whole reports. Reading the project is the way to find them.
- Apply a report theme in Power BI DesktopOn the Design tab, choose Import theme and pick the JSON file. Visuals you formatted by hand keep their own colours until you reset them.
How these pages are written
Every statement about how Power BI behaves comes from a named source: a page on Microsoft Learn or a thread on the Microsoft Fabric forum. Each source shows the date it was read, and a forum reply is never presented as Microsoft's word unless it quotes Microsoft. File excerpts are copied from a public sample project published under the MIT licence, and contain no data.
Written by Vishnu Shankar.
Related
The Power BI error reference explains the messages Power BI Desktop shows for a project, and the Power BI Report Doctor checks a project folder or .zip in your browser. Nothing is uploaded.