Creating Page List

Build List pages for displaying and filtering multiple records in Business Central.

25 minIntermediate

Learning Objectives

  • Create List pages with repeater controls
  • Add sorting and filtering capabilities
  • Configure editable lists
  • Link lists to card pages for drill-down

List Pages

List pages display multiple records in a grid (repeater). They're the entry point for most BC modules — users browse lists and drill into cards.

CustomerBonusList.Page.al
page 50101 "Customer Bonus List"
{
    PageType = List;
    ApplicationArea = All;
    UsageCategory = Lists;
    SourceTable = "Customer Bonus";
    CardPageId = "Customer Bonus Card";
    Editable = false;

    layout
    {
        area(Content)
        {
            repeater(General)
            {
                field("Entry No."; Rec."Entry No.") { }
                field("Customer No."; Rec."Customer No.") { }
                field("Bonus Amount"; Rec."Bonus Amount") { }
                field("Bonus Date"; Rec."Bonus Date") { }
            }
        }
    }
}

Key Properties

PropertyPurpose
CardPageIdPage opened when user drills down
EditableAllow inline editing in the list
SourceTableViewDefault sorting and filtering
UsageCategoryWhere page appears in Tell Me search

SourceTableView for Default Sorting

SourceTableView = sorting("Bonus Date" desc) 
    where("Bonus Amount" = filter(>0));

Info

Setting UsageCategory = Lists makes your page discoverable via the BC search (Tell Me / Alt+Q).

Next Steps

Document pages combine a header with line items — essential for orders, invoices, and journals.

Open Source

Help improve this platform

NAVBC Learning is open source. Report issues, suggest improvements, or join discussions on GitHub.