{"title":"Extensibility overview","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-extensibility-overview/","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-extensibility-overview, 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-extensibility-overview","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":"How you can extend functionality in Dynamics 365 Business Central.","date":"2026-10-29","meta":{"topic":"article"},"outline":[{"level":2,"title":"Extending AL objects and artifacts","slug":"extending-al-objects-and-artifacts","at":558,"chars":2162},{"level":2,"title":"Extending the Business Central application","slug":"extending-the-business-central-application","at":2720,"chars":3682},{"level":3,"title":"Contributing to Business Central applications","slug":"contributing-to-business-central-applications","at":3158,"chars":985},{"level":3,"title":"Extending the Business Central base application","slug":"extending-the-business-central-base-application","at":4143,"chars":504},{"level":3,"title":"Extension objects in the same app","slug":"extension-objects-in-the-same-app","at":4647,"chars":1755},{"level":2,"title":"Examples","slug":"examples","at":6402,"chars":1085},{"level":2,"title":"Related information","slug":"related-information","at":7487,"chars":1658}],"text":"AL developers can extend the functionality of Business Central in several ways. They can extend tables, enumerations, application areas, pages, reports, code flows, and the security model. They can also request missing extensibility points or contribute application changes through the open-source BCApps repository.\nThis article provides an overview of the extensibility options available to AL developers in Business Central including examples on how to extend various features, such as extending item charges, best price calculations, and data archiving.\n## Extending AL objects and artifacts\nThe AL object model in Business Central supports many different ways for developers to extend objects and artifacts in an app.\nAction|Description|Learn more\nExtending Code Flows|Codeunits contain AL code that you can reuse across the application. Developers can subscribe to events in base app codeunits and write custom logic to extend the application's functionality.|Extending AL code flows: events<devenv-event-types>\nExtending Tables|AL developers can add new fields to existing tables or modify the properties of existing fields. This capability allows customization of data structures to fit specific business needs.|Extending AL objects: tables<devenv-table-ext-object>\nExtending Pages|Pages are the main way to display data in Business Central. Developers can add or modify fields, actions, and the layout of existing pages or create new ones.|Extending AL objects: pages<devenv-page-ext-object>\nExtending Reports|Reports provide a structured view of data and are essential for analysis and decision-making. Developers can extend existing reports by adding data items or columns, modifying request pages, or adding new layouts.|Extending AL objects: reports<devenv-report-ext-object>\nExtending the Security Model|Permission sets define what actions a user can perform in Business Central. Developers can create new permission sets or extend existing ones to ensure users have appropriate access rights.|Extending AL objects: security model<devenv-permissionset-ext-object>\nExtending Enumerations|Enumerations, or Enums, are lists of constants that represent a set of values. Developers can extend existing Enums or create new ones to cater to unique business requirements.|Extending AL objects: enumerations<devenv-extensible-enums>\nExtending Application Areas|Application areas help control the visibility of UI elements based on licensing and configuration. Developers can extend these areas to tailor the user interface according to business needs.|Extending AL objects: application areas<devenv-extending-application-areas>\n> NOTE\n> Extending API pages and queries isn't currently possible in Business Central.\n## Extending the Business Central application\nThe Business Central application consists of multiple layers:\n The System Application, which is a set of open-source modules that make it easier to build, maintain, and upgrade on-premises and online apps. These modules let you focus on the business logic and the needs of your users or customers.\n The Base Application, which is the business logic for the functionality in Business Central.\n### Contributing to Business Central applications\nThe BCApps repository<https://github.com/microsoft/BCApps> includes the Base Application, Business Foundation, System Application, Microsoft's first-party apps, and developer tools. If you want to contribute code, determine the type of contribution:\n1. Small bug fixes, product improvements, or customer conveniences; or\n1. New capabilities or larger changes to the existing application platform.\nBefore opening a pull request (PR), Microsoft must approve the related GitHub issue. See Contribute a change yourself<devenv-contribute-extensibility> and the BCApps contribution guidelines<https://github.com/microsoft/BCApps/blob/main/CONTRIBUTING.md>.\nIf you need a missing event, public procedure, or another extensibility point, create-extensibility-request.\nLearn more about the System Application, its module architecture, and how to modify or create new modules in Creating new modules in the system application<devenv-blueprint>.\n### Extending the Business Central base application\nFor more information on how to get started on extending functionality in the base application by extending AL objects and using events, see:\n Application reference for Dynamics 365 Business Central<https://learn.microsoft.com/dynamics365/business-central/application/>\n The Microsoft_Application.app file<devenv-application-app-file>\n Publishing a code-customized base application<devenv-publish-code-customization>\n devenv-extending-application-areas\n### Extension objects in the same app\n> NOTE\n> This feature is available with runtime 13.0 and later and is enabled by default if you're targeting runtime 13.0 and later.\nFrom runtime 13.0 and onwards, large applications have the ability to maintain a separation of concerns. This is achieved by permitting extension objects to coexist with their target within the same app. This facilitates the development of multiple extensions for a single target, all within the same app.\nWhen table extensions live in the same app as their target, their fields and keys are integrated into the base table. This integration eliminates the need for SQL-joins during runtime.\nAll types of extension objects; enums, pages, reports, tables, and XMLports, can coexist with their target within the same app. This allows for various combinations, such as a single table with its table extension, a single page with multiple page extensions, multiple enum extensions, and so forth. This flexibility supports a wide range of application structures and functionalities.\nPermitting extension objects to coexist with their target within the same app is useful for nondisruptive code refactoring within an app. It allows for dividing objects into modules based on specific functionalities, or for preparing to move objects into a separate app in anticipation of future releases.\nWith runtime 13.0, extension objects from a specific app are applied to the target based on the extension object ID. This introduces the following new compiler validations:\n Base objects are prohibited from referencing members from extension objects.\n An extension object can only reference members from other extension objects within the same app if the other extension object has a lower object ID.\n## Examples\nNumerous examples demonstrate how to extend various features in Business Central:\n Extending item charges\n Extending best price calculations\n Extending pages based on date virtual table\n Data archive extension\n Extending document sharing with OneDrive\n Extending templates\n Extending email\nThese resources provide a comprehensive overview of the extensibility options available to AL developers in Business Central.\n Extending item charge distribution methods<devenv-extending-item-charges>\n devenv-extending-best-price-calculations\n Extending pages previously based on the Date virtual table<devenv-extend-pages-based-on-date-virtual-table>\n Extending data archiving<devenv-data-archive-extension>\n Extending document sharing and OneDrive integration<devenv-extending-document-sharing-onedrive>\n Extending customer, vendor, and item templates<devenv-extending-templates>\n Extending email capabilities<devenv-extending-email>\n Extending G/L entry aggregations when posting invoices<devenv-invoice-posting-example>\n Extending the Shopify Connector<devenv-extending-shopify>\n## Related information\nExtending AL objects and artifacts\n devenv-extending-application-areas\n Extending enumerations<devenv-extensible-enums>\n Extending AL code flows: events<devenv-event-types>\n Extending pages<devenv-page-ext-object>\n Extending reports<devenv-report-ext-object>\n Extending the security model<devenv-permissionset-ext-object>\n Extending tables<devenv-table-ext-object>\nExtending the base application\n Contribute a change yourself<devenv-contribute-extensibility>\n create-extensibility-request\n BCApps contribution guidelines<https://github.com/microsoft/BCApps/blob/main/CONTRIBUTING.md>\n Application reference for Dynamics 365 Business Central<https://learn.microsoft.com/dynamics365/business-central/application/>\n The Microsoft_Application.app file<devenv-application-app-file>\n Publishing a code-customized base application<devenv-publish-code-customization>\nExamples\n Example: extending item charge distribution methods<devenv-extending-item-charges>\n Example: extending price calculations<devenv-extending-best-price-calculations>\n Example: extending pages previously based on the Date virtual table<devenv-extend-pages-based-on-date-virtual-table>\n Example: extending data archiving<devenv-data-archive-extension>\n Example: extending document sharing and OneDrive integration<devenv-extending-document-sharing-onedrive>\n Example: extending customer, vendor, and item templates<devenv-extending-templates>\n Example: extending email capabilities<devenv-extending-email>\n Example: extending G/L entry aggregations when posting invoices<devenv-invoice-posting-example>\n Example: extending the Shopify Connector<devenv-extending-shopify>"}