Promoted (Action) Property

Version: Available from runtime version 1.0.

Sets the value that indicates whether the selected action is promoted, which means that it is elevated to a promoted category in the action bar, as well as the group where is it defined. Promoted can also be set on Profiles, see Promoted (Profiles) Property.


With Business Central 2022 release wave 2, the way that you promote actions on pages or page extensions has changed. Promoting actions is defined in a specific section of the page definition and contains a reference to the action. For more information, see Promoted Actions.


Removing the Promoted property on a published action is considered a breaking change. For more information, see AppSourceCop Error AS0031 and UICop Warning AW0013.

Applies to

  • Page actions

Property Value

true promotes the action; otherwise false.


The following code illustrates how to set the Promoted property.

page 50110 PageName
    PageType = Card;

        // Adds the action called "My Actions" to the Action menu 
            action("My Actions")
                Promoted = true;
                PromotedCategory = Process;
                ApplicationArea = All;



This feature allows you to make a copy of an action and place it on the on the action bar where it is easier to find.

In order to specify where the promoted action should be placed, you must also set the PromotedCategory property.

For more information about promoting actions, see Promoted Actions.


The Promoted property only has an effect on actions defined in pages of type Card, Document, List, ListPlus and Worksheet. The Promoted property has also no effect on actions defined in cuegroups.

For more information about the Promoted property used together with the Scope property, see Scope property.


On Tablet client and Phone client, only promoted actions are displayed.

See Also

PromotedIsBig Property
PromotedOnly Property
Promoted (Profiles) Property Actions Overview