Pages and the user interface
Pages and the user interface in Business Central AL development: page types, role centers, actions, views, profiles, deep links, and mobile app development. It also covers the control add-in style guide, role-based UI customization, and page inspection. Use it for questions on designing, extending, and debugging the UI.
- 69Learn pages
- 7subtopics
- 2videos
Path: Development > Programming in the AL language > Pages and the user interface · tier official · system development · narrative reviewed (checked by Opus)
Overview
This section covers how to build and shape the Business Central user interface with AL. The core subtopics are Pages (page objects, extensions, page types, layout controls, FactBoxes), Actions (action areas, promotion, the modern action bar), Role centers (role-tailored home pages, cues, headlines, onboarding checklists), Views on list pages, and Profiles that decide which pages and reports a user role sees.
Key points
- Page types include Card, List, Document, parts, PromptDialog, ConfigurationDialog and NavigatePage; pages can be extended with page extensions.
- Actions can be added, organized and promoted, with a modern action bar that has split buttons and prompt actions that launch Copilot.
- Role centers provide role-tailored home pages with navigation menus, cues, headlines and a user onboarding checklist.
- Views define alternative filtered, sorted and laid-out list views; legacy Role Center views can be migrated to modern list views.
- Profiles, profile extensions and page customization objects control the UI per user role; profiles can also be created or moved through the client.
- Customizing the UI for roles is layered: Role Centers, page extensions, profiles, page customizations, then personalization.
- Page Inspection in the web client shows page structure, data sources, extensions, filters and source table fields (2023 release wave 2).
- Deep links use URL parameters (company, page, report, table, mode, profile, filter, bookmark) and the ms-businesscentral URI scheme for the mobile app.
Subtopics
- Role centers (6 pages)
- Pages (33 pages)
- Actions (10 pages)
- Views (3 pages)
- Profiles (4 pages)
- Creating deep links (2 pages)
- Developing for the Business Central mobile app (8 pages)
More Learn pages
- Control Add-in Style Guide: Learn about the style guide for control add-ins in Dynamics 365 Finance.
- Customize the user interface for user roles: Description of how to customize the User Interface in Business Central by using user roles.
- Designing the User Interface: Provides an overview of the components available when designing a user interface in Business Central
- Inspecting pages: Learn about the structure of a page and its’ underlying data.
Videos, posts and code changes
Linked by a Haiku matcher with a grounding quote from the item’s summary (link/topics.ts); machine-generated.
- #10134 [Bug 646487] Composite layout: focus fix, body-layout gating, and setup UI (code change): “Focus now moves to the newly created theme or header/footer part”
- #10247 [SOA] Show Cc recipients on email messages (code change): “Sales Order Agent email cards now display Cc recipients in a read-only field”
- #9038 [master][Bug]: Page 615 “IC Inbox Transactions”.RunInboxTransactions (code change): “IsFoundationEnabled check replaced by IsBasicOnlyEnabled in RunInboxTransactions”
- #9896 Rename PBI embedded pages (code change): “Embedded Power BI report pages in the Power BI Reports”
- #214 UI knowledge: notification recall needs a known Id; open mixed-type documents through Page Management (code change): “handle multi-document routing through Page Management instead of hard-coded mappings”
- Dynamics 365 Business Central: introducing the new MaskedType enum field-level property. (community post): “MaskType enum property for table fields supports None and Concealed”
- Dynamics 365 Business Central: previewing PDF files in web client using the new ExtendedDataType = Document. (community post): “new ExtendedDataType called Document that enables PDF file previews in web client FactBoxes”
- Business Central ToolTip and ToolTipML Properties Are Now Available on Pages (community post): “ToolTip and ToolTipML properties directly on page objects”
- Use Teaching Tips to Educate and Guide Users (video): “Teaching Tips; Tours with Teaching Tips”
- What’s New: Business Central User Experience (2024 release wave 2) (video): “Access Keys for Additional Languages; Modernized Search with Full-Text Index; Faster Column Resizing”
Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.
What Learn documents here 8 of 69 Learn pages
- learnAction bar improvements2025-05-15
- learnActions in the user interface2025-01-07
- learnActions overview2025-05-15
- learnAdd FactBoxes to Business Central Pages2026-10-06
- learnAdd Menus to Role Center Navigation2026-10-06
- learnAdd pages and reports to Tell me2025-05-15
- learnAdd Tooltips to Table and Page Fields2026-10-06
- learnAdding actions to a page2025-11-14
Show 32 more
- learnArrange Fields Using Grid Control2023-02-06
- learnArranging Fields in Rows and Columns Using a fixed Control2023-02-06
- learnBarcode scanning in mobile app2024-03-27
- learnBehavioral Changes for Promoted Actions2022-10-01
- learnCardPart Pages in Business Central2026-08-24
- learnCommon Promoted Action Groups2022-11-03
- learnControl Add-in Style Guide2021-04-01
- learnCreate a Role Center headline2024-09-09
- learnCreate Custom Filter Tokens in Business Central2026-10-06
- learnCreating and Customizing Cues2024-07-03
- learnCustomize the user interface for user roles2025-01-08
- learnDeciding on Your Tablet and Phone Strategy2026-08-24
- learnDesigning Assisted Setup Guides2025-10-14
- learnDesigning card pages2024-04-26
- learnDesigning for Different Screen Sizes on Tablet and Phone2026-08-24
- learnDesigning Indented Hierarchy Lists2021-04-01
- learnDesigning List Pages for Business Central2021-04-01
- learnDesigning Profiles2021-04-01
- learnDesigning Role Centers2025-06-21
- learnDesigning the User Interface2024-04-22
- learnDevelop a Sales Rep Role Center for the Tablet Client2021-04-01
- learnDifferences and Limitations for Mobile App Page Development2026-08-24
- learnDisplay Data as Tiles2025-05-12
- learnEmbed Power BI reports in pages2025-05-12
- learnError handling in prompt dialogs2026-10-02
- learnExport and package analysis views2026-02-27
- learnField Arrangement on FastTabs2025-01-14
- learnField groups2025-12-25
- learnFormatting the data in a field2026-07-03
- learnGet started developing for the Dynamics 365 Business Central mobile app2024-03-01
- learnGet Users Started with the Checklist2025-01-30
- learnInspecting pages2026-09-18