{"title":"Promoted property on page actions","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/properties/devenv-promoted-action-property/","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/properties/devenv-promoted-action-property, 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/properties/devenv-promoted-action-property","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 the legacy Promoted property adds a page action to a promoted category in Dynamics 365 Business Central and review its behavior.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":1,"title":"Promoted property on page actions","slug":"promoted-property-on-page-actions","at":0,"chars":1600},{"level":2,"title":"Applies to","slug":"applies-to","at":623,"chars":28},{"level":2,"title":"Property value","slug":"property-value","at":651,"chars":116},{"level":2,"title":"Example","slug":"example","at":767,"chars":332},{"level":2,"title":"Remarks","slug":"remarks","at":1099,"chars":360},{"level":2,"title":"Related information","slug":"related-information","at":1459,"chars":141}],"text":"# Promoted property on page actions\n> Version: _Available from runtime version 1.0._\nSpecifies whether a page action is added to a promoted category in the action bar.\n> IMPORTANT\n> The Promoted property is part of the legacy syntax for promoted actions. We recommend that you use the actionref syntax introduced in Business Central 2022 release wave 2. See ../devenv-promoted-actions.\n> NOTE\n> Removing the Promoted property from a published action is a breaking change. See AppSourceCop error AS0031<../analyzers/appsourcecop-as0031>.\nThe Promoted property also applies to profiles. See devenv-promoted-profile-property.\n## Applies to\n Page actions\n## Property value\nSet the property to true to promote the action. Otherwise, set it to false. The default is false.\n## Example\nThe following example uses the legacy syntax to promote an action to the Process category.\n```al\naction(MyAction)\n{\n    Caption = 'Process order';\n    ApplicationArea = All;\n    Promoted = true;\n    PromotedCategory = Process;\n\n    trigger OnAction()\n    begin\n        Message('The order was processed.');\n    end;\n}\n```\n## Remarks\nUse the devenv-promotedcategory-property to specify where the promoted action appears. The Promoted property has an effect on actions on Card, Document, List, ListPlus, and Worksheet pages. It has no effect on actions in cue groups.\nFor information about using Promoted with Scope, see Scope property for page actions<devenv-scope-action-property>.\n## Related information\ndevenv-promotedisbig-property\ndevenv-promotedonly-property\ndevenv-promoted-profile-property\n../devenv-actions-overview"}