---
id: post/aardvarklabs-blog/2063
type: post
title: Understanding User Control Host in Business Central
summary: User Control Host is a new Business Central page type that hosts web pages and custom controls with minimal overhead, designed originally to support Power BI reports and enabling embedded HTML resources without standard page infrastructure.
tier: community
language: en
tags:
  - custom controls
  - user control host
  - page types
  - web page embedding
  - power bi integration
  - al development
system: development
review:
  state: reviewed
  by: opus
  at: "2026-10-08T01:58:22.207Z"
  flags: []
generated:
  at: "2026-10-08T01:26:53.141Z"
  pipeline: 0.2.0
  prompts:
    extract-post: 1
  input_hash: 0e6e1b637bc5d9d4007b7348fce3ed0b1d77aa70080a0e0d765b5c7aaa838ddd
evidence:
  - kind: blog
    url: https://aardvarklabs.blog/2025/11/21/understanding-user-control-host-in-business-central/
    title: Understanding User Control Host in Business Central
    date: "2025-11-21"
    commit: null
    t: null
    quote: null
  - kind: blog
    url: https://aardvarklabs.blog/2025/11/21/understanding-user-control-host-in-business-central/
    title: Understanding User Control Host in Business Central
    date: "2025-11-21"
    commit: null
    t: null
    quote: This page design is so restrictive that you can only have a layout, area, and a single usercontrol object on the page.
  - kind: blog
    url: https://aardvarklabs.blog/2025/11/21/understanding-user-control-host-in-business-central/
    title: Understanding User Control Host in Business Central
    date: "2025-11-21"
    commit: null
    t: null
    quote: They totally created this to help with the Power BI Reporting.
links:
  learn: []
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
post_id: "2063"
source_id: aardvarklabs-blog
source_name: Aardvark Labs
url: https://aardvarklabs.blog/2025/11/21/understanding-user-control-host-in-business-central/
published_at: "2025-11-21T13:00:00.000Z"
author: Marcel Chabot
full_text: false
words: 571
quotes:
  - text: This page design is so restrictive that you can only have a layout, area, and a single usercontrol object on the page.
    why_it_matters: Defines the fundamental constraints of User Control Host and explains why it is simpler than standard page types
  - text: They totally created this to help with the Power BI Reporting.
    why_it_matters: Clarifies the primary use case and motivation for introducing this page type into Business Central
code_objects_mentioned:
  - page ARD_HostControlDemo
  - other WebPageViewer
systems:
  - development
  - reporting
versions_mentioned: []
preview:
  embeddable: true
  frame_url: https://aardvarklabs.blog/2025/11/21/understanding-user-control-host-in-business-central/embed/
  image: https://aardvarklabs.blog/wp-content/uploads/2025/08/9cc7416c-942b-43be-96ed-c7c869c6e751.jpeg
  image_alt: null
  image_w: 1024
  image_h: 1024
  site_name: Aardvark Labs
  favicon: https://aardvarklabs.blog/wp-content/uploads/2024/04/design-1.png?w=32
  probed_at: "2026-10-07T11:51:19.342Z"
---

# Understanding User Control Host in Business Central

[Read the post](https://aardvarklabs.blog/2025/11/21/understanding-user-control-host-in-business-central/) · Aardvark Labs (Marcel Chabot) · 2025-11-21 · 571 words · tier community · reviewed (checked by Opus)

> User Control Host is a new Business Central page type that hosts web pages and custom controls with minimal overhead, designed originally to support Power BI reports and enabling embedded HTML resources without standard page infrastructure.

## Key points

- User Control Host is a simplified page type that requires no source table and supports only a layout, area, and single usercontrol object
- It enables embedding web pages and Power BI reports directly into Business Central with reduced page overhead
- Custom controls require JavaScript and HTML5, building on the foundation of embedded web pages
- The page type is highly restrictive by design, with no actions or editing capabilities, making it the most basic page definition possible
- Dynamic URLs can be constructed to pass parameters like customer numbers or filtered report data to the hosted content

## Quotes

- "This page design is so restrictive that you can only have a layout, area, and a single usercontrol object on the page." (Defines the fundamental constraints of User Control Host and explains why it is simpler than standard page types)
- "They totally created this to help with the Power BI Reporting." (Clarifies the primary use case and motivation for introducing this page type into Business Central)

## AL objects mentioned

As named in the post. A name that matches one object page by exact type and name links to it; the others stay as named.

- page "ARD_HostControlDemo"
- other "WebPageViewer"

Not found in BC28-30: page "ARD_HostControlDemo".

## Context

- Features: User Control Host page type, Custom controls, Web page embedding, Power BI report hosting, HTML5 integration, Dynamic URL parameters

Source: Aardvark Labs, community blog. Summary, key points and quotes are derived (CONTENT-NOTICE.md); read the original for the full text.