Skip to main content
cancel
Showing results for 
Search instead for 
Did you mean: 

The Power BI Data Visualization World Championships is back! Get ahead of the game and start preparing now! Learn more

Reply
New_worker
Helper II
Helper II

PBIR format

Hi-

Here's a definition.pbir file: 

{
"version": "1.0",
"datasetReference": {
"byPath": {
"path": "../Sales.Dataset"
},
"byConnection": null
}
}

I want to confirm the meaning of version=1.0, does it refer to PBIR-Legacy format or jsut a restrict value for version?

Although I walk through the related document, I cannot understand PBIR-Legacy format should be determined by report.json or version=1.0 in .pbir file..

Version Supported formats

1.0Report definition must be stored as PBIR-Legacy in the report.json file.
4.0 or higherReport definition can be stored as PBIR-Legacy (report.json file) or PBIR (\definition folder).

Thanks!

1 ACCEPTED SOLUTION
v-pnaroju-msft
Community Support
Community Support

Thankyou, @ribisht17@Deku, for your response.

Hi New_worker,

We sincerely appreciate your inquiry posted on the Microsoft Fabric Community Forum.

To the best of my understanding, within the Power BI Project (PBIP) format, the file named definition.pbir is itself a PBIP file and is not considered as PBIR-Legacy. The attribute version=1.0 inside definition.pbir dictates how the report content is stored. When the version is 1.0, the report definition must be saved separately in a file named report.json, following the PBIR-Legacy storage format for the report content. For versions 4.0 or above, you may use either report.json (PBIR-Legacy) or the newer \definition folder (PBIR format). Hence, definition.pbir is always in PBIP format, and the version 1.0 simply indicates that the report’s definition must conform to the PBIR-Legacy standard (i.e., using report.json).

If you find our response helpful, we kindly request you to mark it as the accepted solution and provide kudos. This will greatly assist other community members who may have similar queries.

Thank you.

View solution in original post

4 REPLIES 4
v-pnaroju-msft
Community Support
Community Support

Thankyou, @ribisht17@Deku, for your response.

Hi New_worker,

We sincerely appreciate your inquiry posted on the Microsoft Fabric Community Forum.

To the best of my understanding, within the Power BI Project (PBIP) format, the file named definition.pbir is itself a PBIP file and is not considered as PBIR-Legacy. The attribute version=1.0 inside definition.pbir dictates how the report content is stored. When the version is 1.0, the report definition must be saved separately in a file named report.json, following the PBIR-Legacy storage format for the report content. For versions 4.0 or above, you may use either report.json (PBIR-Legacy) or the newer \definition folder (PBIR format). Hence, definition.pbir is always in PBIP format, and the version 1.0 simply indicates that the report’s definition must conform to the PBIR-Legacy standard (i.e., using report.json).

If you find our response helpful, we kindly request you to mark it as the accepted solution and provide kudos. This will greatly assist other community members who may have similar queries.

Thank you.

ribisht17
Super User
Super User

The version=1.0 in the definition.pbir file indicates that the report definition is stored in the PBIR-Legacy format, which means the report metadata is saved in the report.json file. This is consistent with the documentation, where version 1.0 explicitly requires the use of the PBIR-Legacy format.

 

 

Clearly mentioned here Power BI Desktop project report folder - Power BI | Microsoft Learn

Version Supported formats

1.0Report definition must be stored as PBIR-Legacy in the report.json file.
4.0 or higher

Report definition can be stored as PBIR-Legacy (report.json file) or PBIR (\definition folder).

 

 

 

Regards,

Ritesh

Community Champion

Please mark the answer if helpful so that it can help others

Dance-Sing with Data Projects - YouTube

Thank you @ribisht17  for the reply.

 

So, I can understand version=1.0 refers to the report definition must be stored in report.json, which is in PBIR Legacy format. But the statement "definition.pbir is in the PBIR-Legacy format" is wrong, it is still PBIP format, right?
Correct me if I misunderstand. Thanks!

PBIP has two methods of storing the semantic model and report.

 

The semantic model can be stored as legacy in TMSL (model.bim) or TMDL.

 

The report as legacy in report.json or PBIR


Did I answer your question?
Please help by clicking the thumbs up button and mark my post as a solution!

Helpful resources

Announcements
Power BI DataViz World Championships

Power BI Dataviz World Championships

The Power BI Data Visualization World Championships is back! Get ahead of the game and start preparing now!

November Power BI Update Carousel

Power BI Monthly Update - November 2025

Check out the November 2025 Power BI update to learn about new features.

FabCon Atlanta 2026 carousel

FabCon Atlanta 2026

Join us at FabCon Atlanta, March 16-20, for the ultimate Fabric, Power BI, AI and SQL community-led event. Save $200 with code FABCOMM.