{"title":"Working with CardPart pages","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-designing-cardparts/","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-cardparts, 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-cardparts","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 design a CardPart page in Business Central, add it to a Role Center or FactBox, and display data with fields, cue tiles, and control add-ins.","date":"2026-08-24","meta":{"topic":"concept-article"},"outline":[{"level":1,"title":"Working with CardPart pages","slug":"working-with-cardpart-pages","at":0,"chars":3716},{"level":2,"title":"Creating a card part","slug":"creating-a-card-part","at":657,"chars":582},{"level":2,"title":"Adding a card part to a page","slug":"adding-a-card-part-to-a-page","at":1239,"chars":297},{"level":2,"title":"Example","slug":"example","at":1536,"chars":1851},{"level":2,"title":"Related information","slug":"related-information","at":3387,"chars":329}],"text":"# Working with CardPart pages\nA CardPart page is a type of page part that you embed in another page to display more data relevant to the page that hosts it. It can display the data in the form of almost any page control, such as fields, cue tiles, images, or control add-ins. You can also define actions to operate on the card part page.\nYou can place a card part in Role Centers, in the FactBox and content area of other pages, or in a tabular step in a wizard. Depending on the type of the hosting page, a card part is subject to different design constraints, which determine its position and dimensions. See devenv-designing-parts#design-considerations.\n## Creating a card part\nTo create a card part, create a page object, set the properties/devenv-pagetype-property to CardPart, and specify the source table. You can nest different controls inside the `area(Content)` control depending on how you want to display the data. You can specify the following controls.\nControl|Definition\nfield|Defines a field. It can also be used to display an image.\ncuegroup|Defines a group of cue tiles. See Designing cues<devenv-cues-action-tiles#CueDesign>.\nusercontrol|Defines a control add-in. See Control add-in object<devenv-control-addin-object>.\n## Adding a card part to a page\nTo place a card part in a page, add a part control to the hosting page and associate it with the card part page object. Define more properties. These properties only apply to the container of the card part, whose functionality is independent from the hosting page.\n## Example\nThe following code sample shows how to create a CardPart page, `\"Customer Sales History\"`, and how to integrate it in the FactBox area of the card page `\"Customer Card\"`.\n```al\npage 50101 \"Customer Sales History\"\n{\n    PageType = CardPart;\n    SourceTable = Customer;\n\n    layout\n    {\n        area(Content)\n        {\n            // Display data as cue tiles\n            cuegroup(Overview)\n            {\n                field(\"No. of Quotes\"; \"No. of Quotes\")\n                {\n                    ApplicationArea = All;\n                    // Make the cue interactive\n                    DrillDownPageID = \"Sales Quotes\";\n                }\n                field(\"No. of Orders\"; \"No. of Orders\")\n                {\n                    ApplicationArea = All;\n                    DrillDownPageID = \"Sales Order List\";\n                }\n                field(\"No. of Invoices\"; \"No. of Invoices\")\n                {\n                    ApplicationArea = All;\n                    DrillDownPageID = \"Sales Invoice List\";\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            }\n        }\n\n        // Display the card part in the Factbox area\n        area(FactBoxes)\n        {\n            part(\"Customer Sales History\"; \"Customer Sales History\")\n            {\n                // Filter on the sales history that relate to the customer in the card page.\n                SubPageLink = \"No.\" = FIELD(\"No.\");\n            }\n        }\n    }\n}\n```\n## Related information\nPage parts overview<devenv-designing-parts>\ndevenv-page-types-and-layouts\ndevenv-page-object\nPage extension object<devenv-page-ext-object>\ndevenv-adding-a-factbox-to-page\nListPart pages<devenv-designing-listparts>\nAL development environment<devenv-reference-overview>\nUse Designer<devenv-inclient-designer>"}