Change which displays appear in layout regions when your application starts.
How-To Guides → Displays → Modify Layout Startup Pages

Overview

When your application starts, the Startup Layout loads with default pages in each region. This guide shows how to change those default pages.

Steps

1. Open the Layout Editor

  1. Go to Displays → Layouts in the Designer
  2. Select the Startup Layout

2. View Current Region Configuration

The Layout Editor shows all configured regions:

RegionCurrent Page
HeaderHEADER
Menu(none or page name)
ContentMAINPAGE
Footer(none or page name)


3. Change a Region's Startup Page

  1. Select the region you want to modify
  2. In the properties panel, find the Display or Page property
  3. Select the new page from the dropdown (or type the page name)
  4. Save the layout

4. Verify the Startup layout defined in Displays ClientSettings

  1. Go to Displays → Client Settings
  2. Verify if the solution is using the Startup layout when starting, or it was customized to use another one.

5. Test Your Changes

  1. Run the solution
  2. Verify the correct pages appear in each region

Common Tasks

Change the Header Page

  1. Create your new header display (e.g., "MyHeader")
  2. Open Layout Editor
  3. Set Header region → Display = "MyHeader"

Change the Startup Content Page

  1. Create your landing page display (e.g., "Dashboard")
  2. Open Layout Editor
  3. Set Content region → Display = "Dashboard"

Add a Menu (Left Sidebar)

  1. Create a menu display (e.g., "MainMenu")
  2. Open Layout Editor
  3. Enable the Menu region by adding a display name
  4. Set Menu region → Display = "MainMenu"

Tips

  • Header/Menu sizing: Keep dimensions consistent across the application
  • Content pages: Any page can show in Content via navigation — the Layout only sets the initial page
  • Testing: Use Run (F5) to preview your layout changes

See Also

  • Layouts Overview — Understanding layout regions
  • Displays Layouts Reference — Complete layout properties