{"title":"PromotedActionCategories Property","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/properties/devenv-promotedactioncategories-property/","by":"JOP-AL","license":"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-promotedactioncategories-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.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/properties/devenv-promotedactioncategories-property","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Sets a category for a promoted action.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":2,"title":"Applies to","slug":"applies-to","at":99,"chars":20},{"level":2,"title":"Parameters","slug":"parameters","at":119,"chars":428},{"level":2,"title":"Syntax","slug":"syntax","at":547,"chars":312},{"level":2,"title":"Remarks","slug":"remarks","at":859,"chars":1369},{"level":2,"title":"Related information","slug":"related-information","at":2228,"chars":168}],"text":"> Version: _Available or changed with runtime version 1.0._\nSets a category for a promoted action.\n## Applies to\n Page\n## Parameters\nLocked\nType: ../methods-auto/boolean/boolean-data-type\nIf true the PromotedActionCategories is locked and should not be translated.\nComment\nType: ../methods-auto/text/text-data-type\nDescriptive text for the PromotedActionCategories, for example, with regards to translation.\nMaxLength\nType: ../methods-auto/integer/integer-data-type\nSets the maximum length of the specific PromotedActionCategories property value.\n## Syntax\n```al\nPromotedActionCategories = 'New caption,Process caption,Report caption,Category4 caption';\n```\nOr, with parameters:\n```al\nPromotedActionCategories = 'New caption,Process caption,Report caption,Category4 caption', Locked = true, Comment = 'Keep like this, do not translate.', MaxLength = 100;\n```\n## Remarks\n> NOTE\n> 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.\nPromoted actions appear in the action bar on a page. You promote an action by setting the devenv-promoted-property to true. You use the devenv-promotedcategory-property to set the category of an action, which allows you to group similar actions under a common caption. You can choose between 20 categories: New, Process, Report, and Category4 through Category20.\nBy default, the category names are used as the captions in the ribbon. You use this property to customize these captions. The new caption names must be expressed as a string list, where the first three places correspond to the captions of the New, Process and Report categories, respectively, the fourth place to Category4's caption, the fifth to Category5's and so on.\n> NOTE\n> Any empty spaces in the string of promoted action categories are removed. This means that `PromotedActionCategories = 'New caption,,,Category4 caption';` is interpreted as `PromotedActionCategories = 'New caption,Category4 caption';`. To maintain the sequence, you must fill in any empty spaces by, for example, using Category4, Category5 etc.\n## Related information\ndevenv-properties\ndevenv-promoted-property\ndevenv-promotedactioncategoriesml-property\ndevenv-promotedcategory-property\n../devenv-actions-overview"}