ErrorIn the .pbip file1 cause · The Report Doctor detects none yet.

Expected '$schema' property in the .pbip file to follow patterns

Power BI

The message, with the parts that change in brackets:

Expected '$schema' property in '[file]' to follow patterns: [pattern]

What it means

The .pbip file is the one Power BI Desktop opens. It names a schema in $schema, and Desktop checks the address against a pattern before it reads the report or the semantic model. An address that does not fit stops the project.

Usually
The $schema address points at the wrong folder
Fix
Open the .pbip file and set $schema to the address in the pattern the message prints, with a version that fits it.
On this page

How the message appears

Copied exactly from each source. A name in square brackets replaced one from someone else's project.

Expected '$schema' property in '[project name].pbip' to follow patterns:
^https://developer.microsoft.com/json-schemas/fabric/pbip/pbipProperties/1.[0-9]+.[0-9]+/schema.json$
GitHub issue: Cnext-eu/kairos-ontology-toolkit issue 623. Read 2026-10-04.[1]Identifiers replaced

What causes it

  1. The $schema address points at the wrong folder

    A tool wrote the address with fabric/item/pbipProperties where Power BI Desktop wants fabric/pbip/pbipProperties. Desktop failed before it read the report or the model. The issue's author checked both addresses in a follow-up reply: the first returns 404 and the second returns 200. They say the address is the only change the file needs.

    Source: Cnext-eu/kairos-ontology-toolkit issue 623[1].

    The Report Doctor can't detect this, because the Report Doctor does not read the .pbip file.

The fix

Open the .pbip file and set $schema to the address in the pattern the message prints, with a version that fits it. In the quoted case that is 1.0.0.

In [project name].pbip:

Refused by Power BI Desktop
"$schema": "https://developer.microsoft.com/json-schemas/fabric/item/pbipProperties/1.0.0/schema.json"

Line 1: change item to pbip.

Accepted by it
"$schema": "https://developer.microsoft.com/json-schemas/fabric/pbip/pbipProperties/1.0.0/schema.json"

The Power BI Report Doctor cannot find this. It does not read the .pbip file.

Other messages that stop a project opening, by the file that causes each: Power BI Desktop can't open a PBIP.

Worth knowing

  • The wrong address is an easy one to write, because the schemas of the report files use fabric/item/ in theirs.

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