{"title":"The UserControlHost page type","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-page-type-usercontrolhost/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-page-type-usercontrolhost, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-page-type-usercontrolhost","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Learn how to use the UserControlHost page type in Business Central.","date":"2025-03-17","meta":{"topic":"overview"},"outline":[{"level":2,"title":"Example","slug":"example","at":1155,"chars":1954},{"level":2,"title":"Related information","slug":"related-information","at":3109,"chars":71}],"text":"The UserControlHost page type is a specialized page type introduced in Business Central runtime 15.0. It's designed to render a single user control in the client, optimizing the layout to maximize the available space for the control. This page type is particularly useful for embedding Power BI reports or displaying individual pages of such reports. Unlike standard pages, the UserControlHost page type has strict limitations, allowing only one user control in the layout and restricting extensibility and actions. This article provides an overview of the UserControlHost page type, its usage, and an example implementation.\nThe UserControlHost page type can only have a single control of type usercontrol within the layout Content area. Furthermore, you can't specify actions on this page type. Likewise, only a limited number of properties and triggers are available for it and the page type isn't extensible.\nThe following example illustrates the differences between a standard page and a UserControlHost page. The example uses the WebPageViewer user control, which is a simple web browser control that can be used to display web pages in the client.\n## Example\n```al\n// Welcome to your new AL extension.\n// Remember that object names and IDs should be unique across all extensions.\n// AL snippets start with t*, like tpageext - give them a try and happy coding!\n\nnamespace UserControlHost.Demo;\n\nusing System.Integration;\n\npage 50100 StandardPage\n{\n    PageType = Card;\n    Caption = 'Standard Page';\n    AboutTitle = 'About this page';\n    AboutText = 'Displays a single user control in a standard card page';\n    ApplicationArea = All;\n    UsageCategory = Documents;\n\n    layout\n    {\n        area(content)\n        {\n            usercontrol(WebPageViewer; WebPageViewer)\n            {\n                trigger ControlAddInReady(CallbackUrl: Text)\n                begin\n                    CurrPage.WebPageViewer.Navigate('https://www.example.com');\n                end;\n            }\n        }\n    }\n}\n\npage 50101 UserControlHost\n{\n    PageType = UserControlHost;\n    Caption = 'User Control Host Page';\n    AboutTitle = 'About this page';\n    AboutText = 'Displays a single user control in a user control host page';\n    ApplicationArea = All;\n    UsageCategory = Documents;\n\n    // UserControlHost pages aren't extensible (at all)\n    // Extensible = true; // This property isn't supported\n\n    layout\n    {\n        area(content)\n        {\n            // Only a single user control is permitted on pages of type UserControlHost\n            usercontrol(WebPageViewer; WebPageViewer)\n            {\n                trigger ControlAddInReady(CallbackUrl: Text)\n                begin\n                    CurrPage.WebPageViewer.Navigate('https://www.example.com');\n                end;\n            }\n        }\n    }\n\n    // Actions aren't permitted\n    // actions { } // will trigger AL0875\n}\n```\n> TIP\n> Use this page type to show a Power BI report in its own page. See Embed Power BI reports, scorecards, dashboards in pages<devenv-power-bi-report-parts#open-a-power-bi-element-expanded-in-its-own-page>.\n## Related information\ndevenv-page-types-and-layouts\ndevenv-page-object"}