Create page customizations

Completed

With page extensions, you can modify existing pages. You can add new fields, modify some field properties, and write code in the different page triggers. Modifications that are published by using page extensions are visible to all users.

You can also create Page Customization objects. A page customization has more restrictions than a page extension. You can't write code in a Page Customization object; therefore, you can't add variables, create procedures, or access triggers.

You can add changes to existing page layouts by modifying the position of fields or changing field properties. You can also add actions, groups, and page fields that use a table field as the source expression. Page fields that you add in a page customization are read-only by default. Starting with Business Central 2025 release wave 2 (runtime version 16), you can set the Editable property to true on such a field to make it editable.

To control whether the fields of a table can be used as a source expression for new page fields in page customizations, and whether those fields can be made editable, use the AllowInCustomizations property on the table or on the individual table field.

A page customization isn't visible to all users, but they are always linked to a profile. Only users who are assigned to that profile see the customization. A single page customization can be used with multiple profiles within the same extension.

To create a new Page Customization object, you can use the tpagecust snippet. This snippet helps you create a basic layout. A Page Customization object doesn't have a number, just a name.

pagecustomization MyCustomization customizes "Customer List"
{
    actions
    {
        moveafter(Orders; "Blanket Orders")

        modify(NewSalesBlanketOrder)
        {
            Visible = false;
        }
    }
}