{"title":"Use Designer","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-inclient-designer/","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/devenv-inclient-designer, 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/devenv-inclient-designer","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":"Description of how Designer works and is integrated with the AL development experience.","date":"2024-10-01","meta":{"topic":"article"},"outline":[{"level":1,"title":"Use Designer","slug":"use-designer","at":0,"chars":13957},{"level":2,"title":"Designer capabilities","slug":"designer-capabilities","at":1081,"chars":657},{"level":2,"title":"Important points to note","slug":"important-points-to-note","at":1738,"chars":841},{"level":2,"title":"Start and stop designing","slug":"start-and-stop-designing","at":2579,"chars":1154},{"level":2,"title":"Drag-and-drop components","slug":"drag-and-drop-components","at":3733,"chars":241},{"level":2,"title":"Work with fields","slug":"work-with-fields","at":3974,"chars":981},{"level":2,"title":"Set the freeze pane","slug":"set-the-freeze-pane","at":4955,"chars":518},{"level":2,"title":"Set the Importance on a field","slug":"set-the-importance-on-a-field","at":5473,"chars":1502},{"level":2,"title":"Set the Quick Entry on fields","slug":"set-the-quick-entry-on-fields","at":6975,"chars":781},{"level":2,"title":"Work with the Navigation menu and Navigation bar","slug":"work-with-the-navigation-menu-and-navigation-bar","at":7756,"chars":982},{"level":2,"title":"Hide and show Parts","slug":"hide-and-show-parts","at":8738,"chars":605},{"level":2,"title":"Work with Actions","slug":"work-with-actions","at":9343,"chars":2536},{"level":3,"title":"Remove, hide, and show actions and groups","slug":"remove-hide-and-show-actions-and-groups","at":9746,"chars":1216},{"level":3,"title":"Move actions and action groups","slug":"move-actions-and-action-groups","at":10962,"chars":917},{"level":2,"title":"Preview design on different display targets","slug":"preview-design-on-different-display-targets","at":11879,"chars":319},{"level":2,"title":"Control user access to Designer","slug":"control-user-access-to-designer","at":12198,"chars":682},{"level":2,"title":"Other things to know","slug":"other-things-to-know","at":12880,"chars":918},{"level":2,"title":"Related information","slug":"related-information","at":13798,"chars":159}],"text":"# Use Designer\nWhen developing extensions in the AL development environment, you have a wide range of possibilities. Designer in Dynamics 365 Business Central complements the development experience in Visual Studio Code. It provides an easy and convenient way to make immediate changes to your design by dragging and dropping the components on the page.\n> IMPORTANT\n> Currently, Designer is only available from a Dynamics 365 Business Central sandbox.<br> Every time you start designing, you're effectively creating a new extension. Your changes are immediately visible to other users in the sandbox environment.<br> Designer can't be used by multiple users at the same time in sandboxes.\n> NOTE\n> Extensions created by using Designer are removed when the sandbox environment is updated or relocated within our service. Thus, you shouldn't rely on using the sandbox environment as a source control for these Designer extensions. Remember to frequently download and backup the Designer extension source. See Production and Sandbox Environments<../administration/environment-types>.\n## Designer capabilities\nHere's a quick overview of capabilities in Designer:\nFeatures|Applies to\nAdd components|fields, columns, parts, actions in navigation bar\nMove components|fields, columns, cues, parts, actions, and action groups\nRemove components|fields, columns, cues, parts, actions, and action groups\nHide and unhide components|parts\nChange field importance, like showing in collapsed FastTab header or under Show More|fields\nExclude field from Quick Entry|fields, columns\nSet freeze pane and clear freeze pane|columns\nAdjust column width|columns\nEdit caption|FastTabs, cards, FactBoxes\nSave extension/download code|general\nPreview design|general\n## Important points to note\n Every time you start designing, you're effectively creating a new extension. Your changes are immediately visible to other users in the sandbox environment.\n The changes you make in Designer apply to all users.\n You can't remove specific fields that are bound to a page and a field must belong to an underlying table.\n You can only add fields, columns, or tiles to its applicable view from list, tall tiles, and wide tiles views. Some components can't be moved using drag-and-drop and are restricted to the view that they're in.\n You can only add fields/columns, from a predefined list, which is based on the source table. You can't create new ones.\n In the client, users can change many of these settings for their workspace by using personalization. See Personalizing your workspace</ui-personalization-user>.\n## Start and stop designing\nIn the Business Central client, you start Designer by choosing ![Settings icon.] icon and then Design in the top-right corner of any page and start designing using drag-and-drop components. In Visual Studio Code, you can start Designer by using the F6 shortcut key, which launches a browser that opens the Business Central client in Designer.\nAfter you're done with the changes, choose Stop Designing. You can name the extension and download code to save it for the tenant. Once you're done, the extension is automatically installed. If you choose to download the code, the project is downloaded as a .zip folder. You extract the files and open the folder from Visual Studio Code, where you can deploy it as you would do with any other extension.\nIf you choose not to download the code at the end, you can still pull the code using the Alt+F6 shortcut. You can also uninstall the extension from the Extension Management page or even download the source from there. You can find Extension Management page by choosing the search ![Lightbulb that opens the Tell Me feature.] icon and typing the page name.\n![Work with Designer.]\n## Drag-and-drop components\nIn Designer, you design and modify the current page by using drag and drop components. You can display existing table fields, move fields around, remove fields from the page, hide and move actions, and much more.\n## Work with fields\nTo add a field or column to a page, in the banner, choose Field. A pane to the right appears that lets you add fields. Here, you can see all the fields that are available for the specific page. The fields displayed are based on the underlying table or tables. The field can have a status of Placed, which means that the field already exists on the page. A status of Ready means that the field doesn't exists on the page and can be added. To add a field, drag and drop it to the preferred location.\nIf you want to remove a field or column, select the arrowhead indicator ![arrowhead indicator left.] or ![arrowhead indicator down] on the component, and then choose Remove.\nYou can edit the caption of a FastTab (FastTabs divide key information in separate groups and are arranged in columns) by selecting the caption and start writing. A caption should provide a short and clear description. See Field Arrangement on FastTabs<devenv-arranging-fields-on-fasttab>\n## Set the freeze pane\nSet freeze pane locks one or more columns to the left, even when you scroll horizontally. You can set the freeze pane, by selecting the arrowhead indicator or ![arrowhead indicator down] of the column that you want as the last column of the freeze pane, and then choose Set Freeze Pane. If you want to set the freeze pane back to its original designed location, select the arrowhead indicator or ![arrowhead indicator down] for the current freeze pane column, and then choose Clear Freeze Pane.\n## Set the Importance on a field\nFields on nonlist type pages, such as card and document type pages, include Designer options for setting the importance. The following table describes the options for setting the importance in Designer and how it corresponds to the properties/devenv-importance-property in the page code.\nOption|Description|Importance property value\nShow under \"Show more\"|Sets the field so that it appears only when the user selects Show more.|Additional\nShow always|Sets the field to always display on the page. The field is displayed regardless the user selects Show more or Show less. The field doesn't show in the FastTab heading if the FastTab is collapsed.|Standard\nShow when collapsed|Sets the field to always display on the page. The field is displayed regardless the user selects Show more or Show less. The fields also display in the header of the FastTab if the FastTab is collapsed.|Promoted\n> NOTE\n> In version 24 (runtime 14) and earlier, the Importance property is ignored on StandardDialog and ConfirmationDialog page types. This behavior means that a field can't be hidden under the Show more action even if the user tries to do so using personalization or designer. However, starting in version 25 (runtime 15), the property is fully respected in the client so it behaves the same as it does on any other page type. As a result, after upgrading to version 25, users might have a slightly different experience on some StandardDialog and ConfirmationDialog page types.\n## Set the Quick Entry on fields\nYou can use Designer to set the properties/devenv-quickentry-property on a field. The QuickEntry property determines whether the field is skipped when users select the Enter key to navigate through fields on a page. You use Quick Entry to speed up the data entry by keyboard and to focus only on the frequently used fields.\nTo set the QuickEntry property from Designer, select the field or column heading, and then choose either Include in Quick Entry (sets the QuickEntry property to true) or Exclude from Quick Entry (sets the QuickEntry property to false).\nFor more information about QuickEntry property, from a user perspective, see Accelerating Data Entry Using Quick Entry</ui-enter-data#QuickEntry> in the Business Central Application Help.\n## Work with the Navigation menu and Navigation bar\nDesigner lets you add actions that link to pages and reports in the navigation bar using the bookmark icon on the target page or report. The bookmark icon is also available in the Tell Me window.\n> NOTE\n> Bookmarking is only available for pages and reports that are discoverable from Tell Me (search icon on top right). For more information on how to make pages and reports searchable, see Add pages and reports to Tell me<devenv-al-menusuite-functionality>.\nThis feature allows the user to efficiently create multiple links and group together the important or commonly used links for a specific profile in the Role Center navigation bar. For more information about bookmarking, see Bookmark a Link to a Page or Report on Your Role Center</ui-bookmarks> in the Business Central Application Help.\nYou can also move actions to reorder them in the navigation bar, or move them into groups or subgroups to design the Navigation Menu.\n## Hide and show Parts\nDesigner lets you hide and unhide part controls in a page directly from the client. When you select the Hide option on a part, it's grayed-out and disappear from the page when you quit Designer mode. Similarly, you can select Show on a grayed part control to make it visible again to the user.\nThe extension generated when the user hides or shows a part overrides the properties/devenv-visible-property in code. For more information on how the Visible Property affects the visibility of a control, see properties/devenv-visible-property#ui-customization-and-visibility-of-controls.\n## Work with Actions\nDesigner lets you make changes to the actions that are defined in the action bar of a page. You can move, remove, hide, and show individual actions or action groups.\n> NOTE\n> You cannot modify actions that are defined on pages that are shown in parts, such as in FactBoxes or embedded lists.\n> TIP\n> In Designer, to run an action as normal, select the action and select Ctrl+Click.\n### Remove, hide, and show actions and groups\nActions and actions groups that are already hidden appear dimmed. To change the state of an action or action group, select it, and then choose one of the following options:\nOption|What it does\nRemove|This option is available for the actions that are shown only in a promoted category. Or actions that are shown in both, promoted category and another action menu.<br /><br /> Choosing Remove deletes the action from the selected location so that it no longer appears.<br /><br /> If the action is only shown in the promoted category, it's automatically shown in the action menu where it's originally defined.<br /><br />You can't remove actions on a Role Center page; you can only hide them.\nHide|This option is available for actions or action groups that are currently shown only in an action menu (not in a promoted category). Like Remove, choosing Hide makes the action or action group disappear from the action bar in the client. However, in Designer, the action or action group appears dimmed.\nShow|This option appears if the action or action group has been previously hidden (dimmed). Choosing this option makes the action or action group appear in the action bar.\n### Move actions and action groups\nDesigner lets you move actions within the action bar. For example, you can:\n Move an action from an action menu to a promoted category.\n Move an action from one promoted category to another.\n Move an action within an action group or to a different action group.\nTo move an action or action group, drag and drop it to the wanted location, just like with fields and columns.\n You can move individual actions into the promoted categories, but you can't change the order of the actions in the category.\n You can't move an action group into a promoted category.\n To move an action or action group into an empty action group, drag the action or action group to the target group and drop it in the Drop an action here box.\n On Role Center pages, you can't move actions among the different areas that are defined by the `area(creation)`, `area(processing)`, and `area(reporting)` controls.\n## Preview design on different display targets\nThe display type icons let you preview the changes you made on desktop, tablet, and phone clients. This way you can make sure that your design works on the intended display target(s). You can flip to display tablet and phone designs in portrait and landscape orientation.\n## Control user access to Designer\nAccessing Designer is controlled on a user or user group basis by the EXTEN. MGT. - ADMIN permission set. If a user is assigned this permission set, then Designer is available for the user in the client. To prohibit a user from Use Designer, just remove the user from the EXTEN. MGT. - ADMIN permission set.\n> NOTE\n> It's important that the EXTEN. MGT. - ADMIN permission set does not have a company specified; otherwise the user won't be able to access Designer.\n> NOTE\n> The EXTEN. MGT. - ADMIN permission set was introduced in Business Central 2021 release wave 1 as a replacement for the D365 EXTENSION MGT permission set in earlier versions.\n## Other things to know\n Power Automate item in action bar\n   You can't hide or move the Automate item or the Power Automate subitem and its actions Create a flow or Manage Flows.\n   You can move flows included under the Automate item, but you can't hide them. Moving the flow makes a copy of the flow to the destination, it won't remove it from the Automate item. Your flow in Power Automate isn't duplicated.\n     If the action is moved to the repository area of the action bar (right side of |), a new action is created at the drop location.\n     If the action is moved to the promoted area (left side of |) a new actionref is created at the drop location. This actionref points to a new base action that's appended to the Actions menu (Processing action area).\n> TIP\n> You can hide the Automation item from users, but not Use Designer. See Set Up Power Automate Integration<../powerplatform/power-automate-setup>.\n## Related information\nDeveloping Extensions<devenv-dev-overview>\nGet Started with AL<devenv-get-started>\nAL Development Environment<devenv-reference-overview>"}