{"title":"Work with repeater controls","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-repeater-controls/","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-repeater-controls, 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-repeater-controls","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":"A repeater is a control used to define a list of records from the source table of a page.","date":"2022-11-24","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Work with repeater controls","slug":"work-with-repeater-controls","at":0,"chars":5935},{"level":2,"title":"Limitations","slug":"limitations","at":1429,"chars":703},{"level":2,"title":"How to customize a list","slug":"how-to-customize-a-list","at":2132,"chars":1778},{"level":2,"title":"Example","slug":"example","at":3910,"chars":1920},{"level":2,"title":"Related information","slug":"related-information","at":5830,"chars":105}],"text":"# Work with repeater controls\nA repeater control is used to define a list of records from the source table of a page. Records are displayed as rows and columns, where each row is a record and each column is a field.\nYou add a `repeater()` control within the `area(Content)` control of a page, and then you nest a `field()` control for each of the fields from the table specified in the properties/devenv-sourcetable-property that you want to include. The order of the field controls determines the order in which they appear on the page.\nA list is a characteristic element of the layout of pages of the type devenv-simple-list-page-example and devenv-designing-listparts. You define the type of a page using the properties/devenv-pagetype-property. List pages are designed for using a single `repeater()` control, which must be defined at the beginning of the content area. If you include more than one repeater or another control like a group or grid, the page might not behave as expected. If you want to design a page that includes controls in the content area other than a repeater, then try using a Worksheet page type instead. See devenv-page-types-and-layouts.\nPages of the type devenv-api-pagetype are also designed to integrate a repeater control, but they can't be displayed in the user interface.\nThe following figure illustrates how a list created by a repeater is displayed in the Web Client.\n![List part overview.]\n## Limitations\n The Web client doesn't support displaying repeater controls that contain other Parts or FlowFilter fields.\n The repeater control is only supported by the Web client in devenv-page-types-and-layouts#collection-oriented-pages List, Worksheet, and ListPart. The repeater control isn't supported on devenv-page-types-and-layouts#entity-oriented-pages, like Card, CardPart, Document, or Navigation.\n  In fact, if you use a repeater on an entity-oriented page, you'll get UICop Warning AW0008<analyzers/uicop-aw0008>. If you want to include data as a list on one of these page type, create a ListPart page that contains repeater control, and then use the ListPart in the entity-oriented page.\n## How to customize a list\nYou can make various changes to customize the appearance of the list in a page and determine which data is displayed. The changes can be done using AL code or directly from the Web Client.\nTo improve the visibility and readability of the list, you can set some properties at control and field level. For example, you can specify the width of a column using the properties/devenv-width-property. Or, you could set row indentation using the properties/devenv-indentationcolumn-property and properties/devenv-indentationcontrols-property.\nYou should also consider limiting the number of columns and enabling a freeze column by setting the properties/devenv-freezecolumn-property. Apply filters to display only the most relevant data and minimize scrolling. This practice is important when it comes to mobile devices, where there are restrictions as to how much content can be shown. You can also limit data and scrolling by defining a new view on a page. See devenv-views.\nSome other alternative things you can do include:\n Add, move, or hide fields and make adjustments like modifying the column width, directly from the user interface.\n  To apply these changes, use the Designer tool. Go to Use Designer<devenv-inclient-designer>. If these changes are meant for your own workspace, then you use the Personalize tool. See Personalizing Your Workspace</ui-personalization-user>.\n Use the filter pane from the page to sort the data and apply filters. Go to Sorting, Searching, and Filtering</ui-enter-criteria-filters>.\n Use the Tile View to display records as tiles (or bricks) instead of as rows and optimize the space and readability of data. For more information on how to customize the tile view, see Displaying Data as Tiles<devenv-lists-as-tiles>.\n## Example\nThe following example shows how the repeater control is used to define a list page for the Customer table.\n```al\npage 50111 SampleCustomerList\n{\n    PageType = List;\n    ApplicationArea = All;\n    SourceTable = Customer;\n    UsageCategory = Lists;\n    CardPageId = 50112;\n    Caption = 'Sample Customers';\n\n    layout\n    {\n        area(Content)\n        {\n            // Sets the No., Name, Contact, and Phone No. fields in the Customer table to be displayed as columns in the list.\n            repeater(Group)\n            {\n                field(\"No.\"; \"No.\")\n                {\n                    ApplicationArea = All;\n\n                }\n                field(Name; Name)\n                {\n                    ApplicationArea = All;\n\n                }\n                field(Contact; Contact)\n                {\n                    ApplicationArea = All;\n                }\n\n                field(Phone; \"Phone No.\")\n                {\n                    ApplicationArea = All;\n\n                }\n            }\n        }\n    }\n\n    actions\n    {\n        area(Processing)\n        {\n            action(\"Ledger Entries\")\n            {\n                ApplicationArea = All;\n                RunObject = page \"Customer Ledger Entries\";\n                trigger OnAction();\n                begin\n\n                end;\n            }\n        }\n    }\n\n}\n```\nYou can use page customizations to modify the layout of a page for concrete users. The following code hides the `\"Phone No.\"` column from the users with Accountant profile.\n```al\nprofile Accountant\n{\n    Description = 'Functionality for finance staff performing any AR or AP work and managerial reporting.';\n    RoleCenter = \"Accountant Role Center\";\n    Customizations = MyCustomization;\n}\n\npagecustomization MyCustomization customizes \"Customer List\"\n{\n    layout\n    {\n        modify(\"Phone No.\")\n        {\n            Visible = false;\n        }\n    }\n}\n```\n## Related information\ndevenv-pages-overview\ndevenv-designing-list-pages\ndevenv-page-customization-object"}