When PBIP to Production?

Hey ads-nickjtay ,

What Is PBIP (Power BI Project Files)?

PBIP stands for Power BI Project. It’s a new format that stores your Power BI report in a structured set of folders and files rather than a single .pbix binary file. When you save a report in .pbip format using Power BI Desktop, the following happens:

• The report metadata is stored in a .pbip file.

• The dataset definition is exported into a DataModelSchema folder using TMDL (Tabular Model Definition Language).

• The report visual layout is saved in a separate JSON file.

• Other assets like connections and transformations (Power Query) are also stored in structured, text-based files.

This structure enables better integration with source control systems (e.g., Git) and DevOps pipelines, as files can be tracked, diffed, and reviewed like traditional code.

Current Status of PBIP (June 2025)

• Availability: PBIP is still in public preview (as of June 2025).

• GA Date: No official General Availability (GA) date has been announced yet by Microsoft.

• Preview Maturity: It is actively being enhanced, but some limitations remain.

• Usage Recommendation: Microsoft and the Power BI community generally recommend using it in development or test environments for now, not mission-critical production deployments.

Benefits of Using PBIP

1. Version Control Friendly

• Files like report.json and DataModelSchema can be stored in Git.

• You can track changes to your reports, collaborate with teammates, and resolve merge conflicts more easily.

2. Seamless CI/CD Integration

• Supports DevOps workflows with branching, reviewing, pull requests, and automated deployments.

• Works well with Azure DevOps, GitHub Actions, and Fabric deployment pipelines.

3. Improved Developer Experience

• Compatible with Visual Studio Code and other editors.

• Allows scripting or tooling around report files.

4. Granular Control

• Edit TMDL files directly to manipulate data models.

• Manage your workspace using file-based definitions.

Considerations Before Using in Production

1. Stability: As PBIP is in preview, breaking changes may occur. It’s not guaranteed to be backward compatible yet.

2. Incomplete Feature Parity: Some Power BI features are not yet fully supported in .pbip format (e.g., paginated reports, certain visual properties).

3. Collaboration Challenges: While it supports Git integration, merging JSON or TMDL conflicts manually can be complex without discipline and tooling.

4. Lack of Microsoft Support in GA Context: Since this is not GA, Microsoft support may be limited or noncommittal in production-impacting bugs.

When Should You Use PBIP?

For more information visit:
PBIP out of Preview

Power BI Developer Mode is coming!

Why Power BI developers should care about Power BI projects (PBIP)

Create a Power BI report in enhanced report format

Power BI Desktop projects (PREVIEW)

If you found this solution helpful, please consider accepting it and giving it a kudos (Like) it’s greatly appreciated and helps others find the solution more easily.

Best Regards,
Nasif Azam

There's no official date yet. However, a lot of people are already using Power BI Desktop Projects and the TMDL functionality so it is already fairly established.

Which lingering issues are you concerned about?