PromotedOnly Property

Version: Available or changed with runtime version 1.0.

Specifies whether the selected action is promoted only, which means that it will appear only on the Home tab in the ribbon and not on the tab (ActionContainer control) where it is defined.

Applies to

  • Page Action

Property Value

True to set the action as promoted only; otherwise, false. The default value is false.


PromotedOnly = true;



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.

This property is only applicable when the Promoted Property is set to true. For example, if you have an action defined under the ActionItems action container, and you set the Promoted and PromotedOnly properties to true, then in the client, the action will be shown on the Home tab but will be hidden on the Actions tab.

This property in not relevant on the tablet and phone because only promoted actions are displayed on these clients.

See Also

Actions Overview
PromotedOnly Property