{"title":"Page types and layouts","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-page-types-and-layouts/","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-types-and-layouts, 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-types-and-layouts","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":"Compare Business Central page types and layout patterns to choose the right page structure, organize controls, and use screen space effectively.","date":"2026-11-05","meta":{"topic":"concept-article"},"outline":[{"level":2,"title":"Understanding page types","slug":"understanding-page-types","at":474,"chars":6278},{"level":3,"title":"The two principal categories of page types","slug":"the-two-principal-categories-of-page-types","at":4092,"chars":2660},{"level":4,"title":"Entity-oriented pages","slug":"entity-oriented-pages","at":4656,"chars":1299},{"level":4,"title":"Collection-oriented pages","slug":"collection-oriented-pages","at":5955,"chars":529},{"level":4,"title":"Dialog pages","slug":"dialog-pages","at":6484,"chars":268},{"level":2,"title":"Composing pages","slug":"composing-pages","at":6752,"chars":2869},{"level":3,"title":"Content, actions, and FactBox areas","slug":"content-actions-and-factbox-areas","at":7531,"chars":605},{"level":3,"title":"Field groups and page parts","slug":"field-groups-and-page-parts","at":8136,"chars":526},{"level":3,"title":"Sizing of page sections","slug":"sizing-of-page-sections","at":8662,"chars":959},{"level":2,"title":"Card and document page layouts","slug":"card-and-document-page-layouts","at":9621,"chars":2584},{"level":3,"title":"Card layouts","slug":"card-layouts","at":10281,"chars":346},{"level":3,"title":"Document layouts","slug":"document-layouts","at":10627,"chars":651},{"level":3,"title":"The well-designed card or document page","slug":"the-well-designed-card-or-document-page","at":11278,"chars":927},{"level":2,"title":"ListPlus page layouts","slug":"listplus-page-layouts","at":12205,"chars":1713},{"level":2,"title":"List page layouts","slug":"list-page-layouts","at":13918,"chars":1439},{"level":2,"title":"Worksheet page layouts","slug":"worksheet-page-layouts","at":15357,"chars":1846},{"level":2,"title":"Dialog page layouts","slug":"dialog-page-layouts","at":17203,"chars":1738},{"level":2,"title":"Related information","slug":"related-information","at":18941,"chars":274}],"text":"Understanding how Business Central displays a page dependent on its page type is important to be able to create a good user experience. There are also several page properties and variations of the page structures that can help create an intuitive and efficient user interface.\nThis article focuses on pages in a desktop browser. The clients share AL page definitions and adapt supported layouts to the device. Some page types and features have client-specific restrictions.\n## Understanding page types\nChoosing the right page type is the first step when creating or modifying a page. The next step is to organize the page contents to suit its purpose in your solution. We recommend that you design pages based on the user tasks that you want to support.\nThe following table provides an overview of page layout types, their typical uses, and basic characteristics. To specify a page type, use the PageType property. See properties/devenv-pagetype-property.\nReport and XMLport request pages use additional page-type values: ReportPreview, ReportProcessingOnly, and XmlPort. These values describe request pages generated for their parent objects, rather than separate layout patterns in this table. ReportPreview classifies a report's request page, not the report-preview viewer.\nPage type|Examples of use|Main data display|Characteristics\nRoleCenter|Overview of business performance and the start page for a specific user profile.|Defined by the embedded parts.|A collection of parts, such as cues and KPIs, and the contents of the navigation pane.\nCard|Master, reference, and set up data management. devenv-simple-card-page-example|Single entity|Titled entity with FastTabs. Might embed parts.\nDocument|Transaction and other document management.|Single entity|Titled entity with FastTabs. Should have the document lines ListPart immediately follow one or more header sections.\nListPlus|Statistics, details, and related data management.|Single entity|An entity-oriented page designed around one or more ListPart pages, with supporting fields above or below the parts.\nList|Entity overviews and navigation, and inline editing of simple entities. devenv-simple-list-page-example|Collection of entities/entries|A collection displayed in a main repeater. More complex field and part compositions have layout restrictions.\nWorksheet|Line-based data entry tasks, such as journals, and inquiries.|Collection of entities|A main repeater with supporting fields above or below it. ListPart compositions aren't fully supported.\nStandardDialog|Routine dialog that starts or progresses a task.|Single or collection|A cancelable dialog with an instruction to the user. Can have one or more groups of fields and parts.\nConfirmationDialog|Confirmative or exceptional dialog, such as warnings.|Single or collection|A Yes/No dialog with an instruction to the user. Can have one or more groups of fields and parts.\nNavigatePage|A multi-step dialog or wizard.|Single or collection|Can have one or more groups of fields and parts.\nCardPart|A page that is embedded in another page, such as in a FactBox.|Single entity|An entity-oriented part with fields, groups, cues, or other supported controls.\nListPart|A page that is embedded in another page, such as in a FactBox.|Collection of entities/entries|Single Repeater representing columns in a list or table. Can have fields above or below the repeater.\nHeadlinePart|A page that is embedded in a RoleCenter page to display relevant insights from across the business.|Single entity|A role center part whose fields provide rotating headlines.\nPromptDialog|A page that enables creating generative AI experiences with the copilot look and feel|Single or collection.|See devenv-page-type-promptdialog.\nUserControlHost|The UserControlHost is used to render a single user control in the client. The layout is optimized by the client to maximize the available space for the user control.|Single entity|See devenv-page-type-usercontrolhost.\nConfigurationDialog|Configuration dialogs for setting up and managing agents.|Single entity|See devenv-page-type-configuration-dialog.\n### The two principal categories of page types\nA fundamental characteristic of a page type is how it relates to its data. The two principal categories are entity-oriented, typical for Card pages, and collection-oriented, typical for List pages.\nCard, Document, and ListPlus|List and Worksheet\n|\nEntity-oriented pages have actions that operate in the context identified by the page title.|Collection-oriented pages provide actions in the action bar and row menus. These actions can operate on selected rows, but their AL code must obtain and process the selection.\n#### Entity-oriented pages\nIn Business Central, entity-oriented pages are used to support users when their tasks revolve around a single business entity. The most typical entity-oriented page is the Card, which provides details about a single customer or other primary data, and the Document, which represents a single transaction, or other important business event, for example, a sales transaction.\nListPlus is also an entity-oriented page type. Unlike Card and Document pages, the ListPlus page type is for pages that have a prominent ListPart and either few or no header fields.\nThe CardPart page type is an entity-oriented page type for inclusion in another page, for example, in a FactBox.\n> IMPORTANT\n> Because entity-oriented pages represent a single entity, don't use a Repeater group directly in them. Some repeater features might not work properly, and the repeater might not get the expected size. Instead, embed a ListPart page that contains the repeater. See Work with repeater controls<devenv-repeater-controls>.\n> If an existing entity-oriented page uses a repeater, consider changing Card to List, or CardPart to ListPart. Review the controls, layout, actions, and record-selection behavior as part of the change. Pay particular attention to actions and variables used by the grid.\n#### Collection-oriented pages\nCollection-oriented pages support tasks involving multiple entities or records. The most typical collection-oriented page type is List, which users can use to find customers, items, and other entities.\nThe Worksheet page type supports data entry, such as journals, and other tasks for managing a collection. Custom fields above or below the collection provide context for the task.\nThe ListPart page type is a collection-oriented page type for inclusion in another page, for example, in a FactBox.\n#### Dialog pages\nThe page types in Business Central that are available exclusively for displaying dialogs, such as the StandardDialog and ConfirmationDialog page types, can represent an entity or a collection. The title caption and actions are suited for both types.\n## Composing pages\nWithin a page, you can combine page fields into groups. Groups help you overview the page by placing related fields together. Within a group, subgroups further increase the structure of the data displayed in a page.\nYou can also embed a CardPart or ListPart page. These two page types can't embed other pages.\nWhen you create pages that embed parts, Business Central divides the available screen real estate between the page's groups of fields and any embedded pages. Screen space is divided between field groups and embedded pages, so that you can access the full contents of the page and collapse or expand specific sections of interest.\nSpace allocation depends on the page type, the arrangement of field groups and page parts, and the browser window size.\n### Content, actions, and FactBox areas\nConventional pages share a structure with areas for content, FactBoxes, and actions. RoleCenter, dialogs, part pages, and UserControlHost have different structures.\n![Diagram of a page with content and FactBox containers, a page header, and an action bar.]\nThe content area provides rich layout capabilities, which are described in the coming sections. The FactBoxes area is limited to showing a list of parts, usually in a vertical arrangement. The header consists of the title, action bar, and controls for filtering, views, and so on.\nSee devenv-pages-overview.\n### Field groups and page parts\nIn the following sections, you find descriptions of typical page layouts, recommendations for how to organize the contents, and illustrations of the principles by which the sections of page share screen real estate. The types of content on a page are illustrated this way:\nSymbol|Section|Notes\n|Group of fields, or CardPart|Appears on the page as a FastTab, with fields wrapped in one or more columns.\n|ListPart|List or table layout, with integrated action bar.\n|Repeater|List or table layout.\n### Sizing of page sections\nThe groups of fields and page parts making up a page are rendered when the user opens the page.\nDependent on the size of the available screen real estate, for example, in the browser window on a desktop computer, Business Central sizes the sections automatically to make the most of the space.\nA section can use one of three sizing behaviors.\nSymbol|Layout behavior|Notes\n![Closed blue lock representing a section sized to its content.]|Size to content|Enclosing page uses a scrollbar if needed.\n![Purple lock representing content sizing within limits.]|Size to content within certain limits|The part uses a scrollbar if content exceeds available space.\n![Green lock representing a section that fills available space.]|Size to fill space|The part uses a scrollbar if content exceeds available space.\nThe page type determines the section's sizing behavior. The following sections show typical layouts and sizing for each page type.\n## Card and document page layouts\nCard pages support managing primary and reference data, such as customers, vendors, and items. The name Card refers to how you kept this data on paper cards before computerization. Use card pages for setup tasks.\nDocument pages represent transactions or other important business events. They're the computerized counterpart to paper documents, such as quotes, invoices, and orders. Document pages often have associated workflow or audit trail requirements.\nBelow are examples of Card and Document page compositions, showing how space is divided. Parts can be combined in more ways than shown here to suit different scenarios.\n### Card layouts\nExample 1|Example 2|Example 3\nSections are placed vertically from top to bottom of the page.|A ListPart can be embedded. In this case, the ListPart's height is limited.|When a ListPart is embedded as the last part on the page, it expands to fill space.\n![Card layout example 1.]|![Card layout example 2]|![Card layout example 3]\n### Document layouts\nExample 1|Example 2|Example 3\nSections are placed vertically from top to bottom of the page. The lines ListPart comes after the header sections.|Multiple ListParts can be embedded. In this case, the first ListPart is allowed the most space.|When no ListPart is embedded, the Document layout follows the Card layout exactly.\n![Document layout example 1.]|![Document layout example 2]|![Document layout example 3]\n> NOTE\n> The Document page type allows the first ListPart on the page to use extra vertical space before showing a scrollbar. This allows more space for showing the document lines without requiring the user to scroll.\n### The well-designed card or document page\nFrom the user's perspective, the following are qualities of a well-designed card or document page:\n Uses the page type Card if the page represents primary or reference data, or is a setup page.\n Uses the page type Document if the page represents a transaction or other important event in the domain of business.\n Has a page title that clearly identifies the data represented in the page.\n Is optimized for overview by organizing data in FastTabs and marking relevant fields as Promoted or Additional.\n Favor header fields and other important fields by placing them in a General FastTab first.\n Has one or two FactBoxes to give relevant statistics and quick access to related documents.\n For Document pages, a Lines FastTab comes second and contains the document lines.\n Don't include a repeater control, unless the repeater control is in a ListPart page that's embedded in the page.\n## ListPlus page layouts\nListPlus pages support managing or browsing a collection related to a specific entity or event. For example, the Customer Sales page shows sales numbers for a customer and provides viewing options for analysis.\nListPlus pages support analysis and management tasks in the entity context named by the page title. They can show persistent entity data and provide options for viewing or filtering it.\nA ListPlus page should not contain a repeater control but typically embeds a ListPart page that in turn embeds a repeater. In addition, a ListPlus page can embed groups of fields and CardParts. Below are examples of ListPlus page compositions, showing how space is divided. Parts can be combined in more ways than shown here to suit different scenarios.\nExample 1|Example 2|Example 3\nPage sections are placed from top to bottom. The first ListPart fills vertical space.|When placing two or more ListParts, they share available vertical space.|When placing two ListParts in a group, they share horizontal space.\n![ListPlus layout example 1.]|![ListPlus layout example 2]|![ListPlus layout example 3]\nFrom the user's perspective, the following are qualities of a well-designed ListPlus page:\n Has a page title that clearly identifies the context for the information presented in the page.\n Is optimized for showing one set of details, and giving the user means to work with them.\n Presents information in the page in such a way that the hierarchy can be understood when read from top to bottom.\n If present, fields that control which data is presented in another FastTab come before that FastTab.\n If present, fields that show data for the selected row in a ListPart come after that ListPart.\n## List page layouts\nList pages support users viewing and finding specific entities or entries in a collection. Lists that are editable have cells available for data entry and update.\nDesign a list page around one main Repeater. Supported-layout restrictions apply to additional field groups and page parts. The following diagrams show space allocation in different compositions, rather than guaranteeing that every composition is supported. See Work with repeater controls<devenv-repeater-controls>.\nExample 1|Example 2|Example 3\nThe repeater control assumes full vertical space.|When a field group or cardpart is embedded, space for repeater is reduced.|When a listpart is embedded, space is shared equally between part and repeater.\n![List layout example 1.]|![List layout example 2]|![List layout example 3]\nFrom the user's perspective, the following are qualities of a well-designed List page:\n Defines a set of columns that's optimized for viewing and filtering the given collection. Optimize the column order for data entry if the list is editable.\n Has a page title that clearly names or identifies the collection of entities/entries presented.\n If a summary or more detail related to the selected row are shown, these appear below the list.\n If custom viewing options are available, these appear above the list.\n Has one or two FactBoxes to give essential collection statistics, and relevant related details for the selected row.\n## Worksheet page layouts\nA Worksheet page lets users view and manage entries in tabular or matrix form. Use it when custom filters or default field values provide context for the collection. Examples include journals, where the user selects a batch, and inquiry pages, where the user forms a query.\nUse a Worksheet page instead of a List page when header fields determine or subdivide the collection. For example, the user might need to select a header value before the repeater shows data. Also use a Worksheet when header fields provide default values for data entry in the repeater.\n> NOTE\n> The Worksheet page type doesn't support the same part and group compositions as the List page type.\nDesign a worksheet around one main Repeater with supporting fields. More complex page-part compositions, particularly ListPart pages, have support restrictions. The following diagrams illustrate space allocation. They aren't a guarantee that every composition is supported.\nExample 1|Example 2|Example 3\nThe repeater fills vertical space while leaving room for a group or CardPart above.|Content below the repeater is sized to its contents. The main repeater fills the remaining vertical space.|Groups or parts above and below the repeater leave the remaining vertical space for it.\n![Worksheet layout example 1.]|![Worksheet layout example 2]|![Worksheet layout example 3]\nFrom the user's perspective, the following are qualities of a well-designed worksheet page:\n Defines a set of columns that's optimized for overviewing and managing the given collection. Columns are ordered relative to their importance.\n Has fields above the grid that specify filtering options or specify the default values effective during data entry and editing in the grid.\n If summary fields or more details of the selected row are shown, these appear below the repeater.\n## Dialog page layouts\nSome page types in Business Central are available exclusively for displaying dialogs, such as the StandardDialog and ConfirmationDialog page types. You can also use the Dialog data type or a report request page to display a dialog.\nCommon page types, such as Card, Document, and List, can also be displayed as dialogs. They retain their page composition and embedded elements. AL code activates dialog mode, which adds dismiss buttons in the page footer.\n![Diagram of a page shown as a dialog with content, FactBoxes, and dismiss buttons in the footer.]\nGenerally, Business Central displays dialogs on the screen in a frame that is more narrow and not taking up full vertical height, compared to how pages appear ordinarily. Aside from that, pages lay out their contents according to the same principles, whether displayed as a dialog or not.\nGiven the size of the screen where the dialog appears, more or less of the page contents are visible without scrolling. When a page contains much content, it's possible for the user to increase the dialog size with the maximize button.\n> NOTE\n> On desktop, StandardDialog and ConfirmationDialog pages can provide a maximize button. The button isn't shown in Designer.\n> In version 24 and earlier, the properties/devenv-importance-property is ignored on StandardDialog and ConfirmationDialog page types. Version 24 uses runtime 14. This behavior means that a field can't be hidden under the Show more action even through personalization or Designer. Starting in version 25, which uses runtime 15, the property is respected in the client and behaves as it does on other page types. After upgrading to version 25, users might have a different experience on these page types.\n## Related information\nPage, page fields, and page extension properties<properties/devenv-page-property-overview>\nproperties/devenv-pagetype-property\ndevenv-actions-overview\nUse Designer<devenv-inclient-designer>\ndevenv-adding-a-factbox-to-page\ndevenv-designing-role-centers"}