# 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. See ../devenv-promoted-actions.
> NOTE
> Removing the Promoted property from a published action is a breaking change. See AppSourceCop error AS0031<../analyzers/appsourcecop-as0031>.
The Promoted property also applies to profiles. See devenv-promoted-profile-property.
## 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.
```al
action(MyAction)
{
    Caption = 'Process order';
    ApplicationArea = All;
    Promoted = true;
    PromotedCategory = Process;

    trigger OnAction()
    begin
        Message('The order was processed.');
    end;
}
```
## Remarks
Use 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.
For information about using Promoted with Scope, see Scope property for page actions<devenv-scope-action-property>.
## Related information
devenv-promotedisbig-property
devenv-promotedonly-property
devenv-promoted-profile-property
../devenv-actions-overview

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. https://jonas-paprotka.de/docs/dev-itpro/developer/properties/devenv-promoted-action-property/
