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

Required properties are missing from object

Power BI

The message, with the parts that change in brackets:

'[file]': Required properties are missing from object: [property]. Path '[path]', line [n], position [n].

What it means

A file in the report's definition folder has an object without a property its schema requires. The message names the file, the missing property, and the JSON path and line of the object. Microsoft counts a missing required property as a blocking error, so the report does not open until it is fixed.

Usually
An object lost a property its schema requires
Fix
Open the file the message names, go to the line it gives, and add the missing property.

It opens the Report Doctor with this message filled in. Nothing is uploaded.

On this page

How the message appears

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

Error Message:
'pages/[page folder]/visuals/[visual folder]/visual.json':
Required properties are missing from object: name. Path 'filterConfig.filters[2]', line 342, position 7.
Microsoft forum: Required properties are missing from object. Read 2026-10-03.[1]Identifiers replaced

What causes it

  1. An object lost a property its schema requires

    In the quoted case a filter in a visual's filterConfig.filters list has no name. The poster had saved the report in Power BI Desktop and could not open it again. Microsoft Learn says changes made outside Power BI Desktop can also cause it.

    Source: Required properties are missing from object[1], Power BI Desktop project report folder[2].

    The Report Doctor finds this. It reports “A file differs from its schema”, with the file and line.

The fix

Open the file the message names, go to the line it gives, and add the missing property. A filter's name must not match the name of any other filter in the report.

In pages/ReportSection89a9619c7025093ade1c/visuals/3641d5ce63678e76a370/visual.json:

Broken
{
  "field": {

Line 2 changes.

Fixed
{
  "name": "Filterf1ec25bb722d30be4755",
  "field": {

From the SalesSense sample project by Rui Romano (MIT licence).

The Power BI Report Doctor checks each file against the schema it names, and gives the file and line of an object that is missing a property. Nothing is uploaded.

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

Worth knowing

  • The Report Doctor reports a missing required property as a schema warning, with the file and line, because a schema is not exactly what Power BI Desktop opens.

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