Join us at FabCon Atlanta from March 16 - 20, 2026, for the ultimate Fabric, Power BI, AI and SQL community-led event. Save $200 with code FABCOMM.
Register now!The Power BI Data Visualization World Championships is back! Get ahead of the game and start preparing now! Learn more
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.0 | Report 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). |
Thanks!
Solved! Go to Solution.
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.
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.
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.0 | Report 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
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
The Power BI Data Visualization World Championships is back! Get ahead of the game and start preparing now!
Check out the November 2025 Power BI update to learn about new features.
| User | Count |
|---|---|
| 59 | |
| 43 | |
| 42 | |
| 23 | |
| 17 |
| User | Count |
|---|---|
| 190 | |
| 122 | |
| 96 | |
| 66 | |
| 47 |