{"title":"Working with ListPart pages","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-designing-listparts/","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-designing-listparts, 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-designing-listparts","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":"Learn how to create a ListPart page in Business Central and add it to a Role Center, FactBox, or document page to show a list of related records.","date":"2026-08-24","meta":{"topic":"concept-article"},"outline":[{"level":1,"title":"Working with ListPart pages","slug":"working-with-listpart-pages","at":0,"chars":3502},{"level":2,"title":"Creating a list part","slug":"creating-a-list-part","at":626,"chars":538},{"level":2,"title":"Adding a list part to a page","slug":"adding-a-list-part-to-a-page","at":1164,"chars":327},{"level":2,"title":"Example","slug":"example","at":1491,"chars":1654},{"level":2,"title":"Related information","slug":"related-information","at":3145,"chars":357}],"text":"# Working with ListPart pages\nA ListPart page is a type of page part used to display a list of records embedded within another page. It consists of a repeater control, which presents the records of the source table as rows and columns, and optionally, of an action bar.\nA list part can be contained in Role Centers, in the FactBox and content area of other pages, in a tabular step in a wizard, and as a subpage in a document page. Depending on the type of the hosting page, a list part is subject to different design constraints, which determine its position and dimensions. See devenv-designing-parts#design-considerations.\n## Creating a list part\nTo create a list part, you start by creating a page object, set the properties/devenv-pagetype-property to ListPart, and then specify the source table. A list part page uses a single repeater control, located inside `area(Content)`, where you specify the field controls that you want to display. The structure is similar to that of a List page, except that there isn't any FactBox section, because part pages can't host other parts. See List page structure<devenv-designing-list-pages?tabs=structure#structure-1>.\n## Adding a list part to a page\nTo place the list part in a page, you add a part control to the hosting page and associate it with the list part page object that you created. Here you can also define more properties. These only apply to the container of the list part, whose functionality is independent from the hosting page.\n## Example\nThe following code sample illustrates how to create a ListPart page, `\"Pending Shipments\"`, and how to integrate it in the card page `\"Customer Card\"`.\n```al\npage 50101 \"Pending Shipments\"\n{\n    PageType = ListPart;\n    SourceTable = \"Sales Header\";\n    // Filter on the sales orders that are pending completion.\n    SourceTableView = WHERE(\"Completely Shipped\" = CONST(False));\n\n    layout\n    {\n        area(Content)\n        {\n            repeater(General)\n            {\n                field(\"No.\"; \"No.\")\n                {\n                    ApplicationArea = All;\n                }\n                field(\"Order Date\"; \"Order Date\")\n                {\n                    ApplicationArea = All;\n                }\n                field(\"Location Code\"; \"Location Code\")\n                {\n                    ApplicationArea = All;\n                }\n            }\n        }\n    }\n}\n\npage 50102 \"Customer Card\"\n{\n    PageType = Card;\n    SourceTable = Customer;\n\n    layout\n    {\n        area(Content)\n        {\n            group(General)\n            {\n                field(\"No.\"; \"No.\")\n                {\n                    ApplicationArea = All;\n                }\n                field(Name; Name)\n                {\n                    ApplicationArea = All;\n                }\n            }\n            group(Shipments)\n            {\n                part(\"Pending Shipments\"; \"Pending Shipments\")\n                {\n                    // Filter on the sales orders that relate to the customer in the card page.\n                    SubPageLink = \"Sell-to Customer No.\" = FIELD(\"No.\");\n                }\n            }\n        }\n    }\n}\n```\n## Related information\nPage parts overview<devenv-designing-parts>\ndevenv-page-types-and-layouts\ndevenv-designing-list-pages\ndevenv-page-object\nPage extension object<devenv-page-ext-object>\ndevenv-adding-a-factbox-to-page\nCardPart pages<devenv-designing-cardparts>\nAL development environment<devenv-reference-overview>\nUse Designer<devenv-inclient-designer>"}