Business Central 2025 wave 1 (BC26): UserControlHost PageType (New Page type)

Hi, Readers.
The public preview for Dynamics 365 Business Central 2025 release wave 1 (BC26) is available. Learn more: Link.

I will continue to test and share some new features that I hope will be helpful.

This new feature is not yet documented in the Business Central 2025 release wave 1 (BC26) release plan but is mentioned in AL Language extension changelog Version 15.0.

UserControlHost PageType:
We have introduced a new PageType UserControlHost. This page type can be used to only render a single usercontrol in the client. With the UserControlHost page type, the layout is optimized by the client to maximize the available space for the usercontrol.
https://marketplace.visualstudio.com/items/ms-dynamics-smb.al/changelog

Let’s see more details.
UserControlHost: Page to host a single usercontrol.

This new page can only have a single control of type usercontrol within the layout Content area.

Pages with SubType set to UserControlHost must specify exactly one control of type usercontrol in the Content Area AL AL0874

Actions cannot be specified on this page, and limited properties and triggers are available for it. It is also not extensible. For example,

The Property ‘SourceTable’ cannot be used if the property ‘PageType’ is set to ‘UserControlHost’ AL AL0876

Pages with SubType set to UserControlHost do not support actions AL AL0875

Let me try the standard control add-in, WebPageViewer.

Great.

The following two topics we discussed earlier can both be displayed using this new page type.

So you might ask, are there any pages in the standard that use this new type? Yes, this is mainly related to the new feature below.

Embed Power BI content in web client with new page type:

Business value
Experience an enhanced user interface when viewing embedded Power BI reports in Business Central, making it easier to navigate and interact with your data.
Feature details
In this release wave, you can view embedded Power BI reports or pages with a new slim user interface. If the report has multiple pages, you can easily navigate between them using the new navigation option.
https://learn.microsoft.com/en-us/dynamics365/release-plan/2025wave1/smb/dynamics365-business-central/embed-power-bi-content-web-client-new-page-type?wt.mc_id=DX-MVP-5004336

Let’s look at a simple example.
More details: Business Central 2024 wave 2 (BC25.1): Use embedded Power BI reports out of the box (In-client Power BI reports)

Great. Give it a try!!!😁

END

Hope this will help.

Thanks for reading.

ZHU