topic Re: Power BI Embedded and PBIR Format Support in Developer

Power BI Embedded and PBIR Format Support

ponyo_pankun — Mon, 29 Sep 2025 20:00:46 GMT

Hello Experts,

We embed Power BI reports into our custom web app, and per Create a Power BI report in enhanced report format - Power BI | Microsoft Learn, Microsoft makes it look like PBIR format is Power BI Embedded supported.

However, per Power BI enhanced report format (PBIR) in Power BI Desktop developer mode (Preview) | Microsoft Power BI Blog | Microsoft Power BI, under the Limitations section, below are the bullet points:

All service limitations will be addressed in the upcoming months. Specifically, in the next few weeks, we will resolve the following:

Can’t be exported to PPTX or PDF.
Can’t be included in Subscriptions
Mobile layouts aren’t applied.
Can’t be utilized in Power BI Embedded.

Would someone here be able to clarify and confirm whether PBIR format is Power BI Embedded supported?

Re: Power BI Embedded and PBIR Format Support

v-dineshya — Tue, 30 Sep 2025 10:23:02 GMT

Hi @ponyo_pankun ,

Thank you for reaching out to the Microsoft Community Forum.

PBIR format is currently not supported in Power BI Embedded. It is part of the Power BI Project (PBIP) structure, designed to improve source control and developer workflows. While PBIR supports advanced development scenarios, it is still in preview.

According to the official documentation, under the Limitations section. “PBIR format can’t be utilized in Power BI Embedded.” This limitation is expected to be addressed in the upcoming months, but as of now, PBIR reports cannot be embedded into custom applications using Power BI Embedded.

Note: PBIR supports for source control and developer workflows. And not yet supported in Power BI Embedded.

I hope this information helps. Please do let us know if you have any further queries.

Regards,

Dinesh

Re: Power BI Embedded and PBIR Format Support

michellef — Wed, 21 Jan 2026 14:39:46 GMT

With PBIR becoming the default version, will it be supported in embedded by then? Will we need to update our embedded code to handle this? We need communication and documentation on this, please.

Re: Power BI Embedded and PBIR Format Support

ponyo_pankun — Wed, 21 Jan 2026 19:48:42 GMT

@michellef

I asked Rui Romano on this post about 2 months ago. PBIR will become the default Power BI Report Format – Get Ready for the Transition | Microsoft Power BI Blog | Microsoft Power BI.

Below is a screenshot of our conversation, you can more questions and responses if you go to the post. I hope it helps.

Re: Power BI Embedded and PBIR Format Support

michellef — Tue, 27 Jan 2026 21:22:38 GMT

Thanks, have you all tried updating your embedded reports? Our reports don't actually live in a repo. Our .NET code copies the reports from a template workspace into a workspace used for embedding. I guess we will just publish a pbir version instead and see if the code picks it up. 🤞

Re: Power BI Embedded and PBIR Format Support

DocHypoport — Mon, 11 May 2026 10:17:01 GMT

I don't see the limitation anymore on , see link : https://learn.microsoft.com/nl-nl/power-bi/developer/projects/projects-report?tabs=v2%2Cdesktop#pbir-considerations-and-limitations

So solved?

Re: Power BI Embedded and PBIR Format Support

v-dineshya — Mon, 11 May 2026 11:25:43 GMT

Hi @DocHypoport ,

The current “PBIR considerations and limitations” page no longer mentions Power BI Embedded as a limitation, this removal does not mean GA support exists. Microsoft has not announced GA Embedded support for PBIR yet in the roadmap. It still in preview state. Please refer below Mircosoft Road Map link for upcoming release features.

Microsoft Fabric Roadmap

Note: If you want to use Power BI Embedded, Continue embedding reports authored as PBIX. Reports stored in Service but not converted to PBIR-only workflows.

I hope this information helps. Please do let us know if you have any further queries.

Regards,

Dinesh

Re: Power BI Embedded and PBIR Format Support

marcio_fornari — Thu, 06 Aug 2026 12:48:07 GMT

Following up with a concrete, reproducible case (tested today, August 6, 2026), because the mobile layout part of this limitation still reproduces even though the docs no longer list it.

Setup:

Report published from a PBIX; the service stores it as "format": "PBIR" (confirmed via GET https://api.powerbi.com/v1.0/myorg/reports/{reportId}).
Embedded with powerbi-client 2.24.1, AAD token, settings.layoutType = models.LayoutType.MobilePortrait, and pageName explicitly set to the section name of a page that has a mobile layout.

What happens:

Embedding itself works fine — the report loads, data and interactions are all OK (so PBIR does embed).
But the mobile layout is not applied. The SDK fires: mobileLayoutError — Warning: Mobile layout was not found for current page: "<sectionName>", loading page in default layout referencing exactly the page I requested, and the page renders using the desktop layout squeezed into the phone-sized container.
The mobile layout definitely exists on that page: page.mobileSize returns 324 × 2711, page.hasLayout(models.LayoutType.MobilePortrait) returns true, and the same page renders perfectly in the service's mobile layout view and in the Power BI mobile app. Only the embedded rendering refuses to apply it.
Control test: the exact same embed configuration, token and container against a report stored as "format": "PBIRLegacy" applies the mobile layout perfectly (no warning, correct phone rendering). So the only differentiating variable is the stored report format.

Screenshots attached:

Image 1 — the page viewed in the Power BI service mobile layout view (it looks exactly the same in the official Power BI mobile app): the mobile layout renders correctly.
Image 2 — the very same page, same day, embedded with layoutType: MobilePortrait: the mobile layout is ignored and the desktop layout is rendered squeezed into the phone-sized container.

Questions:

Is applying mobile layouts (layoutType: MobilePortrait) in embedded scenarios officially supported today for PBIR-format reports, or is this still a known limitation? The "PBIR considerations and limitations" page no longer mentions it, but the behavior above suggests it is not supported yet.
If it is still a limitation, is there a roadmap item or ETA we can track specifically for mobile layout support in embedded PBIR reports?
Since January 2026 the service stores new/republished reports as PBIR by default, so every republish re-breaks mobile embedding. For ISVs whose embedded apps depend on mobile layouts, what is the recommended path today — restore reports to PBIR-Legacy via report settings and/or have the tenant admin disable the automatic PBIR conversion setting until this is fixed? Both feel temporary given PBIR will become the only format at GA.

Thanks!