Promoted property on page actions

Version: Available from runtime version 1.0.

Specifies whether a page action is added to a promoted category in the action bar.

Important

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. Learn more in Promoted actions.

Note

Removing the Promoted property from a published action is a breaking change. Learn more in AppSourceCop error AS0031.

The Promoted property also applies to profiles. Learn more in Promoted property for profiles.

Applies to

  • Page actions

Property value

Set the property to true to promote the action. Otherwise, set it to false. The default is false.

Example

The following example uses the legacy syntax to promote an action to the Process category.

action(MyAction)
{
    Caption = 'Process order';
    ApplicationArea = All;
    Promoted = true;
    PromotedCategory = Process;

    trigger OnAction()
    begin
        Message('The order was processed.');
    end;
}

Remarks

Use the 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.

For information about using Promoted with Scope, see Scope property for page actions.

PromotedIsBig property
PromotedOnly property
Promoted property for profiles
Actions overview