{"title":"Page parts overview","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-designing-parts/","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-designing-parts, 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-designing-parts","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 choose and embed Business Central page parts, link related data, and design part layouts, actions, visibility, and background tasks.","date":"2026-11-05","meta":{"topic":"overview"},"outline":[{"level":1,"title":"Page parts overview","slug":"page-parts-overview","at":0,"chars":6285},{"level":2,"title":"Hosting parts on a page","slug":"hosting-parts-on-a-page","at":341,"chars":981},{"level":2,"title":"Different types of parts","slug":"different-types-of-parts","at":1322,"chars":842},{"level":2,"title":"Adding a part to a page","slug":"adding-a-part-to-a-page","at":2164,"chars":602},{"level":2,"title":"Design considerations","slug":"design-considerations","at":2766,"chars":3091},{"level":3,"title":"Part size","slug":"part-size","at":2791,"chars":294},{"level":3,"title":"Part actions","slug":"part-actions","at":3085,"chars":487},{"level":3,"title":"Collapsed or expanded parts","slug":"collapsed-or-expanded-parts","at":3572,"chars":771},{"level":3,"title":"Choosing the visibility of parts","slug":"choosing-the-visibility-of-parts","at":4343,"chars":809},{"level":3,"title":"Using page background tasks","slug":"using-page-background-tasks","at":5152,"chars":296},{"level":3,"title":"Additional part restrictions","slug":"additional-part-restrictions","at":5448,"chars":409},{"level":2,"title":"Related information","slug":"related-information","at":5857,"chars":428}],"text":"# Page parts overview\nParts are pages designed to be embedded within another page in Business Central. The hosting page can contain one or more page parts. Use parts to display related information, such as data from a table that differs from the hosting page's source table. Parts let you reuse the same functionality across multiple pages.\n## Hosting parts on a page\nThe following table illustrates how parts can be arranged on a page.\nIllustration of page pattern|Explanation\n![Illustration of a role center page consisting of multiple parts.]|Pages of type RoleCenter typically contain multiple page parts. These parts display business headlines, key performance indicators, and other cues to help users get an overview of their work.\n|Most page types can display FactBoxes in the FactBox pane to show information related to the current record.\n![Illustration of a document page displaying an embedded list.]|Pages of type Document model transactional data that typically consists of a header and detailed lines. These records come from different tables, so a part displays lines from a related table.\n|Related lists can be displayed above each other. One list can display records related to the selected record in another list.\n|When users need to compare records from two tables, parts can be displayed side by side.\n## Different types of parts\nBusiness Central offers different types of parts that display data in a specific way.\nPart type|Purpose|Hosting page types\nListPart pages<devenv-designing-listparts>|Display a list of records.|Role centers; FactBoxes on pages of type Card, Document, Worksheet, List, ListPlus; tabular step in a wizard; subpage on a Document page.\nCardPart pages<devenv-designing-cardparts>|Flexible canvas for page controls, such as fields, cue tiles, charts, images, or control add-ins.|Role centers; FactBoxes on pages of type Card, Document, Worksheet, List, ListPlus; step in a wizard.\ndevenv-power-bi-report-parts|Display Power BI reports using a CardPart page.|Role centers; FactBoxes; Card pages.\nHeadlinePart pages<devenv-create-role-center-headline>|Display relevant insights from across the business.|Role centers only.\n## Adding a part to a page\nTo add a part in Visual Studio Code, add a part control to the hosting page object and reference the page part object. The control defines properties such as the caption that accompanies the part. The page part object defines its functionality, while the hosting page defines how the part's container behaves.\nFor complete examples, see Adding a list part to a page<devenv-designing-listparts#example> and Adding a card part to a page<devenv-designing-cardparts#example>.\nLearn more about part control properties in Page properties<properties/devenv-page-property-overview>.\n## Design considerations\n### Part size\nThe client determines a page-part container's size based on its location, surrounding content, and available display space. AL part properties don't let you specify its preferred, minimum, or maximum height or width. Control add-ins within a part have separate sizing properties.\n### Part actions\nA part can define actions that operate on its fields or open another page. The hosting page and the part's location determine how the action menu is displayed.\n Role center parts and ordinary FactBoxes use condensed action menus.\n On desktop, top-level content parts can display an expanded action bar when the hosting page supports it. Supported hosts include card pages, document pages, and supported task dialogs. Parts inside FastTabs generally use condensed menus.\n### Collapsed or expanded parts\nThe area in which a part is embedded on a page determines whether the part can be collapsed.\n You can't collapse individual parts in the FactBoxes or RoleCenter area. This behavior differs from collapsing the entire FactBox pane.\n You can collapse ordinary parts in the Content area when the parts are hosted on a supported task dialog, card, or document page, provided they're not inside a FastTab.\nBusiness Central determines whether parts are initially expanded or collapsed. For example, when a document page opens for the first time without saved user settings, the first two eligible parts or FastTabs are expanded and the others are collapsed. Users can change this state in the client. Developers can't specify the starting state.\n### Choosing the visibility of parts\nHide parts on the hosting page to provide an optimal starting experience. For example, hide a part that contains secondary content or information needed by only some users. To hide a part, set its Visible property to false on the hosting page.\nUsers can display hidden parts through personalization and role customization. You can also use an expression to control visibility, for example, based on whether an administrator has set up a feature. Learn more about dynamic visibility in properties/devenv-visible-property#dynamic-visibility-of-controls.\n> NOTE\n> You can't use AL code on the hosting role center page to dynamically change a part's visibility, because custom logic on role center pages is ignored. Use static visibility settings and personalization instead.\n### Using page background tasks\nLike other page types, a part page can use one or more page background tasks. However, a part page doesn't display data until all its page background tasks have completed. See Designing part pages for page background tasks<devenv-page-background-tasks#partpages>.\n### Additional part restrictions\n Parts can either represent self-contained functionality, or can be contextual and exchange information with the hosting page.\n A part can't be hosted within another part. Business Central allows a maximum of one level of page nesting.\n The web client doesn't support parts inside repeater controls.\n Parts aren't intended to be displayed on their own without a hosting page.\n## Related information\nAL development environment<devenv-reference-overview>\ndevenv-page-types-and-layouts\ndevenv-adding-a-factbox-to-page\ndevenv-create-role-center-headline\nListPart pages<devenv-designing-listparts>\nCardPart pages<devenv-designing-cardparts>\ndevenv-power-bi-report-parts\nPage extension object<devenv-page-ext-object>\nPersonalizing your workspace</ui-personalization-user>\nUse Designer<devenv-inclient-designer>"}