# 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.
## Syntax
```al
PromotedOnly = true;
```
## 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. See ../devenv-promoted-actions.
> NOTE
> Removing the Promoted property on a published action is considered a breaking change. See AppSourceCop Error AS0031<../analyzers/appsourcecop-as0031> and UICop Warning AW0013<../analyzers/uicop-aw0013>.
This property is only applicable when the devenv-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.
## Related information
../devenv-actions-overview
devenv-promotedonly-property

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-promotedonly-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-promotedonly-property/
