devenv-promoted-action-property.md

title	description	ms.date	ms.topic	author
Promoted (Action) Property	Sets the value that indicates whether the selected action is elevated to a promoted category in the action bar.	07/08/2021	reference	SusanneWindfeldPedersen

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.

Note

With [!INCLUDE prod_short] 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.

Note

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.

Example

The following code illustrates how to set the Promoted property.

page 50110 PageName
{
    PageType = Card;

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

...

Remarks

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.

Note

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.

Note

On [!INCLUDEd365fin_tablet_md] and [!INCLUDEd365fin_phone_md], only promoted actions are displayed.

See Also

PromotedIsBig Property
PromotedOnly Property
Promoted (Profiles) Property Actions Overview