---
id: topic/dev-itpro/development/programming-in-the-al-language/pages-and-the-user-interface
type: topic
title: Pages and the user interface
summary: "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."
tier: official
language: en
system: development
review:
  state: reviewed
  by: opus
  at: "2026-10-07T21:13:11.932Z"
  flags: []
generated:
  at: "2026-10-08T06:31:25.130Z"
  pipeline: 0.2.0
  prompts:
    hub-topic: 1
  input_hash: eeaeb9c6d784351de6ca48d87217cde5159e1cf954a2141fc0aa91a59408804d
evidence:
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-action-bar-improvements
    title: Action bar improvements
    date: "2025-05-15"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-actions-user-interface
    title: Actions in the user interface
    date: "2025-01-07"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-actions-overview
    title: Actions overview
    date: "2025-05-15"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-adding-a-factbox-to-page
    title: Add FactBoxes to Business Central Pages
    date: "2026-10-06"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-adding-menus-to-navigation-pane
    title: Add Menus to Role Center Navigation
    date: "2026-10-06"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-al-menusuite-functionality
    title: Add pages and reports to Tell me
    date: "2025-05-15"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-adding-tooltips
    title: Add Tooltips to Table and Page Fields
    date: "2026-10-06"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-adding-actions-to-a-page
    title: Adding actions to a page
    date: "2025-11-14"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-arrange-fields-in-rows-and-columns-using-gridlayout-control
    title: Arrange Fields Using Grid Control
    date: "2023-02-06"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-arrange-fields-in-rows-and-columns-using-fixedlayout-control
    title: Arranging Fields in Rows and Columns Using a fixed Control
    date: "2023-02-06"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-mobile-app-barcode-scanning
    title: Barcode scanning in mobile app
    date: "2024-03-27"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-promoted-actions-behavioral-changes
    title: Behavioral Changes for Promoted Actions
    date: "2022-10-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-designing-cardparts
    title: CardPart Pages in Business Central
    date: "2026-08-24"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-common-promoted-action-groups
    title: Common Promoted Action Groups
    date: "2022-11-03"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-control-addin-style
    title: Control Add-in Style Guide
    date: "2021-04-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-create-role-center-headline
    title: Create a Role Center headline
    date: "2024-09-09"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-adding-filter-tokens
    title: Create Custom Filter Tokens in Business Central
    date: "2026-10-06"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-cues-action-tiles
    title: Creating and Customizing Cues
    date: "2024-07-03"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-role-customization
    title: Customize the user interface for user roles
    date: "2025-01-08"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-deciding-on-tablet-and-phone-strategy
    title: Deciding on Your Tablet and Phone Strategy
    date: "2026-08-24"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-designing-navigate-pages
    title: Designing Assisted Setup Guides
    date: "2025-10-14"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-designing-card-pages
    title: Designing card pages
    date: "2024-04-26"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-designing-different-screen-sizes-tablet-and-phone
    title: Designing for Different Screen Sizes on Tablet and Phone
    date: "2026-08-24"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-indented-hierarchy-lists
    title: Designing Indented Hierarchy Lists
    date: "2021-04-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-designing-list-pages
    title: Designing List Pages for Business Central
    date: "2021-04-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-design-profiles
    title: Designing Profiles
    date: "2021-04-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-designing-role-centers
    title: Designing Role Centers
    date: "2025-06-21"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-designing-user-interfaces
    title: Designing the User Interface
    date: "2024-04-22"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-walkthrough-developing-sales-rep-rolecenter-business-central-tablet-client
    title: Develop a Sales Rep Role Center for the Tablet Client
    date: "2021-04-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-differences-and-limitations-developing-pages-business-central-mobile-app
    title: Differences and Limitations for Mobile App Page Development
    date: "2026-08-24"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-lists-as-tiles
    title: Display Data as Tiles
    date: "2025-05-12"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-power-bi-report-parts
    title: Embed Power BI reports in pages
    date: "2025-05-12"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-page-prompt-error-handling
    title: Error handling in prompt dialogs
    date: "2026-10-02"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-analysis-view-package
    title: Export and package analysis views
    date: "2026-02-27"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-arranging-fields-on-fasttab
    title: Field Arrangement on FastTabs
    date: "2025-01-14"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-field-groups
    title: Field groups
    date: "2025-12-25"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-format-field-data
    title: Formatting the data in a field
    date: "2026-07-03"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-getting-started-developing-business-central-mobile-app
    title: Get started developing for the Dynamics 365 Business Central mobile app
    date: "2024-03-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/onboarding-checklist
    title: Get Users Started with the Checklist
    date: "2025-01-30"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-inspecting-pages
    title: Inspecting pages
    date: "2026-09-18"
    commit: null
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-control-addin-style
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-role-customization
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-designing-user-interfaces
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-inspecting-pages
  objects: []
  features: []
  topics:
    - topic/dev-itpro/development/programming-in-the-al-language
    - topic/dev-itpro/development/programming-in-the-al-language/pages-and-the-user-interface/role-centers
    - topic/dev-itpro/development/programming-in-the-al-language/pages-and-the-user-interface/pages
    - topic/dev-itpro/development/programming-in-the-al-language/pages-and-the-user-interface/actions
    - topic/dev-itpro/development/programming-in-the-al-language/pages-and-the-user-interface/views
    - topic/dev-itpro/development/programming-in-the-al-language/pages-and-the-user-interface/profiles
    - topic/dev-itpro/development/programming-in-the-al-language/pages-and-the-user-interface/creating-deep-links
    - topic/dev-itpro/development/programming-in-the-al-language/pages-and-the-user-interface/developing-for-the-business-central-mobi
  localizations: []
  videos:
    - video/2Zz55J8rt8I
    - video/rWZcmEwwVHg
  posts:
    - post/demiliani-com/12498
    - post/demiliani-com/12623
    - post/sauravdhyani-com/tag-blogger-com-1999-blog-3122193036149030463-post-9167085598395012736--e9edbb4eee
  guidelines: []
  changes:
    - change/bcapps/10134
    - change/bcapps/10247
    - change/bcapps/9038
    - change/bcapps/9896
    - change/bcquality/214
learn_toc_path:
  - Development
  - Programming in the AL language
  - Pages and the user interface
toc_file: dev-itpro/TOC.md
parent: topic/dev-itpro/development/programming-in-the-al-language
children:
  - topic/dev-itpro/development/programming-in-the-al-language/pages-and-the-user-interface/role-centers
  - topic/dev-itpro/development/programming-in-the-al-language/pages-and-the-user-interface/pages
  - topic/dev-itpro/development/programming-in-the-al-language/pages-and-the-user-interface/actions
  - topic/dev-itpro/development/programming-in-the-al-language/pages-and-the-user-interface/views
  - topic/dev-itpro/development/programming-in-the-al-language/pages-and-the-user-interface/profiles
  - topic/dev-itpro/development/programming-in-the-al-language/pages-and-the-user-interface/creating-deep-links
  - topic/dev-itpro/development/programming-in-the-al-language/pages-and-the-user-interface/developing-for-the-business-central-mobi
coverage:
  learn: 69
  code: 0
  video: 2
  blog: 3
  guideline: 0
bc_forms: []
member_hash: 4b85c5a961bfa013683b351bf15cdd48537c4ed457c3eb55957b8da3fe6729b7
narrative: generated
---

# 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.

Path: [Development](../../development.md) > [Programming in the AL language](../programming-in-the-al-language.md) > 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](pages-and-the-user-interface/role-centers.md) (6 pages)
- [Pages](pages-and-the-user-interface/pages.md) (33 pages)
- [Actions](pages-and-the-user-interface/actions.md) (10 pages)
- [Views](pages-and-the-user-interface/views.md) (3 pages)
- [Profiles](pages-and-the-user-interface/profiles.md) (4 pages)
- [Creating deep links](pages-and-the-user-interface/creating-deep-links.md) (2 pages)
- [Developing for the Business Central mobile app](pages-and-the-user-interface/developing-for-the-business-central-mobi.md) (8 pages)

## More Learn pages

- [Control Add-in Style Guide](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-control-addin-style): Learn about the style guide for control add-ins in Dynamics 365 Finance.
- [Customize the user interface for user roles](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-role-customization): Description of how to customize the User Interface in Business Central by using user roles.
- [Designing the User Interface](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-designing-user-interfaces): Provides an overview of the components available when designing a user interface in Business Central
- [Inspecting pages](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-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](../../../../changes/bcapps/10134.md) (code change): "Focus now moves to the newly created theme or header/footer part"
- [#10247 [SOA] Show Cc recipients on email messages](../../../../changes/bcapps/10247.md) (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](../../../../changes/bcapps/9038.md) (code change): "IsFoundationEnabled check replaced by IsBasicOnlyEnabled in RunInboxTransactions"
- [#9896 Rename PBI embedded pages](../../../../changes/bcapps/9896.md) (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](../../../../changes/bcquality/214.md) (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.](../../../../posts/demiliani-com/12498.md) (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.](../../../../posts/demiliani-com/12623.md) (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](../../../../posts/sauravdhyani-com/tag-blogger-com-1999-blog-3122193036149030463-post-9167085598395012736--e9edbb4eee.md) (community post): "ToolTip and ToolTipML properties directly on page objects"
- [Use Teaching Tips to Educate and Guide Users](../../../../videos/2Zz55J8rt8I.md) (video): "Teaching Tips; Tours with Teaching Tips"
- [What's New: Business Central User Experience (2024 release wave 2)](../../../../videos/rWZcmEwwVHg.md) (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.