PromotedCategory Property

Version: Available or changed with runtime version 1.0.

Sets a category for a promoted action.

Applies to

• Page Action

Property Value

Value	Available or changed with	Description
New	runtime version 1.0	Actions will appear in the New menu.
Process	runtime version 1.0	Actions will appear in the Process menu.
Report	runtime version 1.0	Actions will appear in the Report menu.
Category4	runtime version 1.0	Actions will appear in the Category 4 menu.
Category5	runtime version 1.0	Actions will appear in the Category 5 menu.
Category6	runtime version 1.0	Actions will appear in the Category 6 menu.
Category7	runtime version 1.0	Actions will appear in the Category 7 menu.
Category8	runtime version 1.0	Actions will appear in the Category 8 menu.
Category9	runtime version 1.0	Actions will appear in the Category 9 menu.
Category10	runtime version 1.0	Actions will appear in the Category 10 menu.
Category11	runtime version 1.0	Actions will appear in the Category 11 menu.
Category12	runtime version 1.0	Actions will appear in the Category 12 menu.
Category13	runtime version 1.0	Actions will appear in the Category 13 menu.
Category14	runtime version 1.0	Actions will appear in the Category 14 menu.
Category15	runtime version 1.0	Actions will appear in the Category 15 menu.
Category16	runtime version 1.0	Actions will appear in the Category 16 menu.
Category17	runtime version 1.0	Actions will appear in the Category 17 menu.
Category18	runtime version 1.0	Actions will appear in the Category 18 menu.
Category19	runtime version 1.0	Actions will appear in the Category 19 menu.
Category20	runtime version 1.0	Actions will appear in the Category 20 menu.

Example

The following code sample illustrates how to set the PromotedCategory 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

Note

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.

Promoted actions appear in the action bar on a page. You promote an action by setting the Promoted Property. Categories allow you to group similar actions under a common caption. You can choose between 10 categories: New, Process, Report, and Category4 through Category10. By default, the category names are used as the captions in the ribbon.

See Also

Properties Promoted Property
Actions Overview