{"title":"Actions overview","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-actions-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-actions-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-actions-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":"Learn how to organize Business Central page actions into menus and groups so that users can find tasks, open pages, and run reports or flows.","date":"2025-05-15","meta":{"topic":"overview"},"outline":[{"level":2,"title":"Types of actions","slug":"types-of-actions","at":1702,"chars":670},{"level":2,"title":"Actions menu","slug":"actions-menu","at":2372,"chars":963},{"level":3,"title":"Actions for creating documents","slug":"actions-for-creating-documents","at":2945,"chars":390},{"level":2,"title":"Navigation to related information","slug":"navigation-to-related-information","at":3335,"chars":313},{"level":2,"title":"Actions for running reports","slug":"actions-for-running-reports","at":3648,"chars":268},{"level":2,"title":"Promoted actions","slug":"promoted-actions","at":3916,"chars":678},{"level":2,"title":"Run Power Automate flows from page actions","slug":"run-power-automate-flows-from-page-actions","at":4594,"chars":1334},{"level":2,"title":"Grouping actions in submenus","slug":"grouping-actions-in-submenus","at":5928,"chars":1514},{"level":2,"title":"Actions at runtime","slug":"actions-at-runtime","at":7442,"chars":1236},{"level":2,"title":"Related information","slug":"related-information","at":8678,"chars":171}],"text":"On many page types in Business Central, the action bar at the top of the page displays actions. Dialogs and part pages have specialized action layouts. Some page types don't support page actions. This article explains how to organize actions so that users can quickly find the tasks they need.\nThe actions can be displayed in different menus on the action bar.\n![Screenshot of a Business Central page with action menus and promoted actions in the action bar.]\nYou can choose from the following action menus to place the actions in the specified area.\nArea|Syntax|Used on|Description|Example\n---------------|--|-------|-----------|-------\nActions menu|`area(processing)`|Role center, list, card, and task pages|User tasks|Post a sales order\nNew document group in Actions menu|`area(creation)`|List, card, role center, and task pages|Actions for creating new records or documents. Menu labels and placement depend on the client layout.|New sales invoice\nRelated-information menu|`area(navigation)`|List, card, and task pages|Links to other pages in Business Central.|Prices\nReports menu|`area(reporting)`|Role center, list, card, and task pages|A list of available reports.|Customer Top 10 List\nThe following actions are related to the role center page.\nArea|Syntax|Used on|Description|Example\nNavigation menus|`area(sections)`|Role center pages|The top-level navigation consists of one or more root items that expand to display a submenu of links to other pages.|Posted sales invoices\nNavigation bar|`area(embedding)`|Role center pages|The second-level navigation displays a flat list of links to other pages.|Customers\nLearn more about actions on the role center page in devenv-designing-role-centers.\n## Types of actions\nThe actions available on a page depend on the page type and the processes it supports. To create the right set of actions, understand your customer's business processes.\nEach process in an organization has several actions associated with it. Create actions that cover the tasks and processes users perform.\nFor example, the Sales Orders list page includes sales-order processing actions. Use profile customization and personalization to hide or promote some actions in the action bar. Provide the actions the customer needs, even if some users choose to hide them.\nPages can have the following actions as described in each of the following sections.\n## Actions menu\nOn pages that support it, the Actions menu contains tasks relevant to the current page. Use the processing action area for processing tasks, such as posting a sales order. Use the creation action area for creating records or documents. See devenv-adding-actions-to-a-page.\nSome creation actions on the Customer page are:\n Sales Quote\n Sales Order\n Sales Invoice\n Sales Credit Memo\nYou can add actions to the Actions menu, group them into submenus, or promote them in the action bar. See devenv-page-object and Page extension object<devenv-page-ext-object>.\n### Actions for creating documents\nCreation actions are grouped for creating new records or documents, such as a sales invoice. Their menu label and placement depend on the client layout. Use the creation action area to define these actions.\nFor example, an order processor can create a new invoice directly from the Customers page. This setup provides quick access to a common daily task.\n## Navigation to related information\nThe related-information menu contains navigation actions that open specific pages in Business Central. Use the navigation action area to add these page links. They provide quick access to related information.\n> NOTE\n> Don't add a navigation action area to a role center page.\n## Actions for running reports\nThe Reports menu lists reports relevant to a page. The menu is hidden when it has no visible actions. Promote frequently used reports in the action bar to make them easier to find. Use the reporting action area to define report actions.\n## Promoted actions\n> NOTE\n> With Business Central 2022 release wave 2, the way that you promote actions on pages or page extensions has changed. Define promoting actions in a specific section of the page definition. This section contains a reference to the action. See devenv-promoted-actions.\nPromoted actions are defined in the processing, creation, navigation, or reporting areas and referenced by promoted action groups. You can keep an action in its original menu or show it only in its promoted location. Use promoted actions on Card, Document, List, ListPlus, and Worksheet pages to provide quick access to common tasks. Place them in the appropriate action-bar groups.\n## Run Power Automate flows from page actions\n> APPLIES TO: Business Central 2022 release wave 2 and later\nWith Business Central 2022 release wave 2, it's possible to define page actions that trigger a Power Automate instant flow by using custom actions. Custom actions are defined next to other actions, but use the customaction keyword instead. The syntax is as follows:\n```al\ncustomaction(MyFlowAction)\n{\n    CustomActionType = Flow;\n    FlowId = '<FlowId>';\n    FlowEnvironmentId = '<FlowEnvironmentId>';\n\n}\n```\nFor an action that runs an existing instant flow, set the properties/devenv-customactiontype-property to Flow. Set the properties/devenv-flowid-property to the flow's ID. Set the properties/devenv-flowenvironmentid-property to identify its Power Automate environment. Replace the placeholders in the following example with your flow's values.\n> TIP\n> Get the flow and environment IDs in Power Automate. Sign in to Power Automate<https://powerautomate.com> and open the flow for editing. In the browser URL, find the environment ID after `/environments/` and the flow ID after `/flows/`. These segments have the form `https://make.powerautomate.com/environments/<FlowEnvironmentId>/flows/<FlowId>`.\nLearn more about Power Automate flows in Power Automate integration overview<../powerplatform/power-automate-overview>.\n## Grouping actions in submenus\nWithin an action area, use a `group()` control to organize actions into submenus. The following fragment preserves two nested groups and three report actions. The first and third actions run the same report to illustrate the menu structure. Add the fragment to a page's definition.\n```al\nactions\n{\n    area(Reporting)\n    {\n        action(\"Report 1\")\n        {\n            ApplicationArea = All;\n            Caption = 'Report 1';\n            RunObject = report \"Standard Sales - Invoice\";\n            ToolTip = 'Run the sales invoice report.';\n        }\n\n        group(Group1)\n        {\n            Caption = 'Group1';\n            action(Action2)\n            {\n                ApplicationArea = All;\n                Caption = 'Report 2';\n                RunObject = report \"Customer/Item Sales\";\n                ToolTip = 'Run the customer item sales report.';\n            }\n            group(Group2)\n            {\n                Caption = 'Group2';\n                action(Action3)\n                {\n                    ApplicationArea = All;\n                    Caption = 'Report 3';\n                    RunObject = report \"Standard Sales - Invoice\";\n                    ToolTip = 'Run the sales invoice report.';\n                }\n            }\n        }\n    }\n}\n```\n> NOTE\n> Before Business Central 2019 Wave 2, the client automatically placed submenus before single actions on the same level. This placement means, for example, group Group2 appears before the action Report 2.\n## Actions at runtime\nAn action can run code that posts a document or modifies table records. After the action, the client refreshes the current source record when applicable:\n If no records remain, the page initializes a record from the filters.\n If the current record remains within the filters, OnAfterGetRecord can run for that record.\n If the current record moves outside the filters, the page uses OnNextRecord to move to another record. If the move succeeds, OnAfterGetRecord runs for that record.\nOnAfterGetRecord can also run before the action.\nThe logic runs in the transaction that the action triggered. This behavior can cause the application code to lock the whole table when users thought they were only modifying one record.\nUse methods-auto/page/page-setselectionfilter-method to pass selected records to processing code. Locking still depends on the operations and triggers that code executes. The following triggers-auto/action/devenv-onaction-action-trigger fragment requires a custom processing codeunit with ID `50000` that accepts the page's record type.\n```al\nif confirm('Are you sure you want to call this codeunit?', true) then begin\n    CurrPage.SetSelectionFilter(Rec);\n    codeunit.Run(50000, Rec);\nend;\n```\n## Related information\nAL development environment<devenv-reference-overview>\nDeveloping extensions in AL<devenv-dev-overview>\ndevenv-pages-overview\ndevenv-promoted-actions"}