Promoted action groups and action references


This content is archived and is not being updated. For the latest documentation, go to What's new and planned for Dynamics 365 Business Central. For the latest release plans, go to Dynamics 365 and Microsoft Power Platform release plans.

Enabled for Public preview General availability
Admins, makers, marketers, or analysts, automatically Sep 1, 2022 Oct 1, 2022

Business value

Up until now, it has been possible to promote actions by setting a property in the action that pointed to predefined promoted action categories. This was not flexible, and the personalization story wasn't optimal. In this release we are adding a new promoted action model to address these shortcomings, while retaining the old model for compatibility.

Feature details

Pages and page extensions can now contain a new action group for promoted actions. These groups can contain references to existing actions. It's possible to add to already existing groups or add new groups in page extensions. Users can personalize their experience by promoting actions themselves. The platform and client will stay backward-compatible by keeping the existing promoted actions property, but a page or page extension must be consistent in using either the old or the new model. There will be a code action to convert from the old model to the new.

Tell us what you think

Help us improve Dynamics 365 Business Central by discussing ideas, providing suggestions, and giving feedback. Use the forum at

See also

Promoted Actions (docs)