Change which displays appear in layout regions when your application starts.
How-To Guides → Displays → Layouts → Concept | How-to Guide | Reference
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
- Go to Displays → Layouts in the Designer
- Select the Startup Layout
2. View Current Region Configuration
The Layout Editor shows all configured regions:
| Region | Current Page |
|---|
| Header | HEADER |
| Menu | (none or page name) |
| Content | MAINPAGE |
| Footer | (none or page name) |
3. Change a Region's Startup Page
- Select the region you want to modify
- In the properties panel, find the Display or Page property
- Select the new page from the dropdown (or type the page name)
- Save the layout
4. Verify the Startup layout defined in Displays ClientSettings
- Go to Displays → Client Settings
- Verify if the solution is using the Startup layout when starting, or it was customized to use another one.
5. Test Your Changes
- Run the solution
- Verify the correct pages appear in each region
Common Tasks
- Create your new header display (e.g., "MyHeader")
- Open Layout Editor
- Set Header region → Display = "MyHeader"
Change the Startup Content Page
- Create your landing page display (e.g., "Dashboard")
- Open Layout Editor
- Set Content region → Display = "Dashboard"
- Create a menu display (e.g., "MainMenu")
- Open Layout Editor
- Enable the Menu region by adding a display name
- 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