{"title":"Field groups (DropDown controls)","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-field-groups/","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-field-groups, 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-field-groups","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":"Discover how to use the `fieldgroups` keyword to configure DropDown and Brick field groups in table and table extension objects.","date":"2025-12-25","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Field groups (DropDown controls)","slug":"field-groups-dropdown-controls","at":0,"chars":3264},{"level":2,"title":"Add fields for a drop-down control","slug":"add-fields-for-a-drop-down-control","at":1442,"chars":1179},{"level":2,"title":"Adding new field groups","slug":"adding-new-field-groups","at":2621,"chars":464},{"level":2,"title":"Related information","slug":"related-information","at":3085,"chars":179}],"text":"# Field groups (DropDown controls)\nA field group in table or table extension objects defines the fields to display in a drop-down control on pages that use the table. The DropDown control is used to select a record from a list of records.\nIn a table object, you define field groups by first adding a fieldgroups control, and then adding one or more `fieldgroup(<Name>; <Field>)` keywords for each group, where:\n `<Name>` can be either DropDown, for adding fields to the drop-down control, or Brick to display data as tiles.\n `<Field>` is a comma-separated list of the fields, by name, to include in the group.\n> NOTE\n> A field group can also be used to specify fields that display when list type pages are shown in the tile view. See Displaying data as tiles<devenv-lists-as-tiles>.\n```al\nfieldgroups\n{\n  fieldgroup(DropDown; Field1, Field2)\n  {\n\n  }\n  fieldgroup(Brick; Field1, Field2)\n  {\n\n  }\n}\n```\n> NOTE\n> The fieldgroups keyword can't be inserted before the key control.\n> IMPORTANT\n> The syntax for using a DropDown must be spelled DropDown with the right capitalization.\nIn a table extension object, the fieldgroups control allows you to add more fields to a field group defined for the table object. This can be done by using the `addlast(<name>; <field>)` keyword.\n> WARNING\n> The server removes the duplicates, if multiple extensions attempt to add the same field more than once. A field can only be added to the field group once.\n## Add fields for a drop-down control\nYou add a field to include in a drop-down control by using the DropDown field group name in the keyword.\nThe following example illustrates how to add the field:\n```al\ntableextension 50100 CustomerExercise extends Customer\n{\n    fields\n    {\n        field(50100; \"V02Max\"; Decimal) { }\n    }\n\n    fieldgroups\n    {\n        addlast(DropDown; V02Max) { }\n    }\n}\n```\n> NOTE\n> If the field you're adding to the DropDown has `Visibility = false` on the underlying lookup page, it won't show up in the drop-down.\nIf we want to add the \"Address 2\" field to the Ship-to Address DropDown, the following code illustrates the changes needed to add the \"Address 2\" field to the Ship-To Address DropDown fieldgroup. The underlying lookup page is the Ship-To Address List, where Address 2 has the Visibility property set to false.\n```al\ntableextension 50101 ShipToAddressExercise extends \"Ship-to Address\"\n{\n    fieldgroups\n    {\n        addlast(DropDown; \"Address 2\"){}\n    }\n}\n\npageextension 50101 ShipToAddressExercise extends \"Ship-to Address\"\n{\n    layout\n    {\n        modify(\"Address 2\")\n        {\n            Visible = true;\n        }\n    }\n}\n```\n## Adding new field groups\n> APPLIES TO: Business Central 2023 release wave 2 (version 23) and later\nIt's always possible to add fields to the two predefined field groups, DropDown and Brick. If they aren't defined on the target table, they're dynamically created and contain only the fields specified in the addlast controls.\nThe ordering of the fields is determined by the order in which extensions are loaded by the server, while removing any duplicate fields.\n## Related information\nDebugging in AL<devenv-debugging>\nDeveloping extensions<devenv-dev-overview>\nMicrosoft .NET Interoperability from AL<devenv-get-started-call-dotnet-from-al>"}