{"title":"Arranging fields in rows and columns by using the grid control","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-arrange-fields-in-rows-and-columns-using-gridlayout-control/","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-arrange-fields-in-rows-and-columns-using-gridlayout-control, 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-arrange-fields-in-rows-and-columns-using-gridlayout-control","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":"Arrange Business Central page fields in grid columns, control caption visibility, and understand the web client's limits for row layouts and field spanning.","date":"2026-10-09","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Arranging fields in rows and columns by using the grid control","slug":"arranging-fields-in-rows-and-columns-by-using-the-grid-control","at":0,"chars":4064},{"level":2,"title":"Set up a grid in a FastTab","slug":"set-up-a-grid-in-a-fasttab","at":667,"chars":2730},{"level":3,"title":"Example of a grid control","slug":"example-of-a-grid-control","at":878,"chars":2519},{"level":2,"title":"Row and column spanning in the web client","slug":"row-and-column-spanning-in-the-web-client","at":3397,"chars":273},{"level":2,"title":" Hide field captions","slug":"hide-field-captions","at":3670,"chars":184},{"level":2,"title":"Related information","slug":"related-information","at":3854,"chars":210}],"text":"# Arranging fields in rows and columns by using the grid control\nUse a grid control to arrange groups of page fields in columns. Ordinary FastTabs automatically arrange fields and adjust to the available screen space. See Field arrangement on FastTabs<devenv-arranging-fields-on-fasttab> and devenv-arranging-fields-using-grid-and-fixed-controls.\n> IMPORTANT\n> The web client partially supports grid controls. The web client doesn't support `GridLayout = Rows`, RowSpan, and ColumnSpan. Use column layouts and test the page at the screen sizes your users need.\nIn the web client, a grid control lets you arrange groups of fields in columns and show or hide captions.\n## Set up a grid in a FastTab\nPlace the grid control inside a page group. Add groups inside the grid to define columns. Use `GridLayout = Columns` for a column layout. See properties/devenv-gridlayout-property.\n### Example of a grid control\nThe following example arranges customer information in columns. It also shows a nested grid.\n```al\npage 50113 \"Customers Page\"\n{\n    PageType = Card;\n    SourceTable = Customer;\n    layout\n    {\n        area(content)\n        {\n            group(General)\n            {\n                grid(MyGrid)\n                {\n                    GridLayout = Columns;\n                    group(\"General Info\")\n                    {\n                        field(\"No.\"; Rec.\"No.\")\n                        {\n                            ApplicationArea = All;\n                            Caption = 'No.';\n                            ToolTip = 'Specifies the customer number.';\n                        }\n                        field(Name; Rec.Name)\n                        {\n                            ApplicationArea = All;\n                            Caption = 'Name';\n                            ToolTip = 'Specifies the customer name.';\n                        }\n                        field(\"E-Mail\"; Rec.\"E-Mail\")\n                        {\n                            ShowCaption = false;\n                            ApplicationArea = All;\n                            Caption = 'E-Mail';\n                            ToolTip = 'Specifies the customer email address.';\n                        }\n                    }\n                    group(\"Address Details\")\n                    {\n                        grid(Grid2)\n                        {\n                            group(GridForm)\n                            {\n                                field(Address; Rec.Address)\n                                {\n                                    ApplicationArea = All;\n                                    Caption = 'Address';\n                                    ToolTip = 'Specifies the customer address.';\n                                }\n                                field(\"Post Code\"; Rec.\"Post Code\")\n                                {\n                                    ApplicationArea = All;\n                                    Caption = 'Post Code';\n                                    ToolTip = 'Specifies the customer postal code.';\n                                }\n                            }\n                        }\n                    }\n                }\n            }\n        }\n    }\n}\n```\nThe following screenshot illustrates the column layout in the web client.\n![Customer page with general information in the left grid column and address details in the right column.]\n## Row and column spanning in the web client\nThe web client doesn't support field spanning. Setting RowSpan or ColumnSpan doesn't produce the spanning layouts from the former Windows client. See properties/devenv-rowspan-property and properties/devenv-columnspan-property.\n##  Hide field captions\nTo hide a field or group caption, set `ShowCaption = false`. The following example hides the email field's caption. See properties/devenv-showcaption-property.\n## Related information\nField arrangement on FastTabs<devenv-arranging-fields-on-fasttab>\ndevenv-arranging-fields-using-grid-and-fixed-controls\ndevenv-arrange-fields-in-rows-and-columns-using-fixedlayout-control"}