Required properties are missing from object
Power BIThe message, with the parts that change in brackets:
'[file]': Required properties are missing from object: [property]. Path '[path]', line [n], position [n].
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.
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.
What causes it
An object lost a property its schema requires
In the quoted case a filter in a visual's
filterConfig.filterslist has noname. 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:
{
"field": {Line 2 changes.
{
"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
- [1]Microsoft forum: Required properties are missing from object. The original post. Read 2026-10-03.
- [2]Microsoft Learn: Power BI Desktop project report folder. "External changes to PBIR files" and "Common PBIR errors". Read 2026-10-03.
Did this page help?
It tells us which pages to fix first.