ErrorIn a project JSON file1 cause · The Report Doctor detects none yet.

The /$schema property in report.json must be provided as a const

Power BI

The message, with the parts that change in brackets:

The /$schema property in [file] must be provided as a const.

What it means

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.
On this page

How the message appears

Copied exactly from each source.

The /$schema property in report.json must be provided as a const.
Microsoft forum: PBIP Error: "The /$schema property in report.json must be provided as Const.". Read 2026-10-03.[1]

What causes it

  1. 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:

Refused by that Power BI Desktop
"$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/report/1.1.0/schema.json"

Line 1: change 1 to 0.

Opened by it
"$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 $schema version 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

Did this page help?

It tells us which pages to fix first.

What you put into the tools never leaves your browser. We count page views and keep them for 90 days. Accept and we also remember this browser, so a return visit is not counted as new. Privacy policy