The /$schema property in report.json must be provided as a const
Power BIThe message, with the parts that change in brackets:
The /$schema property in [file] must be provided as a const.
Every PBIR file names the schema version it follows in $schema. Power BI Desktop accepts the versions it knows. A file that names another version is refused with this message.
- Usually
- The file was saved by a newer release
- Fix
- Open the project in a Power BI Desktop release that knows the version the file names.
How the message appears
Copied exactly from each source.
The /$schema property in report.json must be provided as a const.What causes it
The file was saved by a newer release
In the quoted case the report was changed in the Power BI service workspace and pulled to a local repository through Git. The reply marked as the solution changed the schema version from 1.1.0 to 1.0.0.
Source: PBIP Error: "The /$schema property in report.json must be provided as Const."[1].
The Report Doctor can't detect this, because which versions are accepted depends on the release of Power BI Desktop that opens the file, and the files do not say.
The fix
Open the project in a Power BI Desktop release that knows the version the file names. If you cannot update, set $schema back to a version your release knows, as in the quoted answer.
In report.json:
"$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/report/1.1.0/schema.json"Line 1: change 1 to 0.
"$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/report/1.0.0/schema.json"The Power BI Report Doctor cannot find this. Which schema versions Power BI Desktop accepts depends on its release, which it cannot see.
Other messages that stop a project opening, by the file that causes each: Power BI Desktop can't open a PBIP.
Worth knowing
Watch outSetting a version back only works while the file uses nothing the newer version added. Check what changed in the file before you rely on it.
- The Report Doctor reports a
$schemaversion it does not have as a note, and checks every version it has. Can't resolve schema '[version]' in 'report.json'is a different message, with a different fix. See Can't resolve schema in report.json.
Sources
- [1]Microsoft forum: PBIP Error: "The /$schema property in report.json must be provided as Const.". The original post, and the answer marked as the solution. Read 2026-10-03.
Did this page help?
It tells us which pages to fix first.