---
title: UI Layouts
description: "UI layouts are used to arrange multiple UI content (i.e. UI boxes and HUDs). UI layouts are found in **UI > UI Layouts**. The position of a UI box or HUD will be ignored when using them in a UI…"
url: "https://orkframework.com/guide/ork4/ork4-documentation/section-ui/ui-layouts/"
updated: "2026-07-22"
category: "ORK 4 Documentation / Section: UI"
---

# UI Layouts

UI layouts are used to arrange multiple UI content (i.e. UI boxes and HUDs).

UI layouts are found in **UI > UI Layouts**.

The position of a UI box or HUD will be ignored when using them in a UI layout. Instead, they are positioned according to the used layout's settings and other UI content in the same layout. UI layouts are e.g. available in HUDs to arrange multiple HUD instances depending on each other, or by battle menus showing sub-menus using a UI layout.

# Basics

Some basics are shared across all available layout types.

## Anchor and Padding

The layout's *Anchor* and *Padding* settings define where on screen the layout will be placed.

The *Anchor* (white text on the image below) defines where on the available space the layout will be placed - the corresponding layout's corner will be placed on the anchor, e.g. using *Upper Left* will place the layout's upper left corner on that position.

The *Padding* (red letters on the image below) defines the space between the edges of the screen and the layout's placement.

[![](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__padding_anchors.png)](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__padding_anchors.png)

## Shared Layouts

When selecting a UI layout, you can optionally use a *Shared Layout*, i.e. a global layout, that can be accessed from different UI parts, adding different UI content to a single layout. E.g. arranging different HUDs together instead of only the multiple instances of a single HUD.

When not using a shared layout, each UI using a layout will create their own instance of the layout - all existing separate from each other. E.g. different HUDs being added to separate layouts (of the selected layout), arranging them apart from each other.

# Layout Types

There are multiple types of built-in layouts available and you can easily add new layouts to the system by deriving from the *UIBaseLayoutSettings* class for the layout's settings and the *UIBaseLayout *class for the layout's implementation. See the built-in layout classes for an example, as they're using the same system.

## Offset

The *Offset* layout type places UI content by adding an offset to the previous UI content's position. You can define which corner of the previous UI content the next should be placed relative to (e.g. the *Upper Left* corner).

[![](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__offset.png)](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__offset.png)

## List

The *List* layout type places UI content in a *Horizontal* or *Vertical* list with a defined spacing between them.

Here's an example of a *Horizontal* list.

[![](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__list_horizontal.png)](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__list_horizontal.png)

Here's an example of a *Vertical* list.

[![](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__list_vertical.png)](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__list_vertical.png)

## Row

The *Row* layout type places UI content in rows - similar to a horizontal list - but defines the maximum number of content per row (or the number of rows to be filled). Using *Horizontal* filling, each row is filled until a defined number is reached. Using *Vertical* filling, rows will be filled until a defind number of rows is reached.

Here's an example for a horizontally filled row with 3 per row, aligning rows on the left side and placed on the *Upper Left*.

[![](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__row_upper_left.png)](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__row_upper_left.png)

Here's an example for a vertically filled with 3 rows, aligning rows in the center and placed in the *Middle Center*.

[![](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__row_middle_center.png)](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__row_middle_center.png)

Here's an example for a horizontally filled row with 3 per row, aligning rows on the right side and placed on the *Lower Right* and using reversed horizontal and vertical order (i.e. filling from bottom right to upper left).

[![](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__row_lower_right.png)](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__row_lower_right.png)

## Column

The *Column* layout type places UI content in columns - similar to a vertical list - but defines the maximum number of content per column (or the number of columns to be filled). Using *Vertical* filling, each column is filled until a defined number is reached. Using *Horizontal* filling, columns will be filled until a defind number of columns is reached.

Here's an example for a vertically filled column with 3 per column, aligning columns on the top and placed on the *Upper Left*.

[![](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__column_upper_left.png)](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__column_upper_left.png)

Here's an example for a horizontally filled column with 3 columns, aligning columns in the middle and placed in the *Middle Center*.

[![](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__column_middle_center.png)](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__column_middle_center.png)

Here's an example for a vertically filled column with 3 per column, aligning columns on the bottom and placed on the *Lower Right* and using reversed horizontal and vertical order (i.e. filling from bottom right to upper left).

[![](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__column_lower_right.png)](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__column_lower_right.png)

## Grid

The *Grid* layout type places UI content in a grid - similar to row or column - but places the content in 'cells', which are depending on all UI content added to the layout. Using *Horizontal* filling, the grid is filled row-wise until a defined number is reached. Using *Vertical* filling, the grid is filled column-wise until a defined number is reached.

Here's an example for a horizontally filled grid with 3 per row, placed in the *Middle Center*.

[![](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__grid_horizontal.png)](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__grid_horizontal.png)

Here's an example for a vertically filled grid with 3 per column, placed in the *Middle Center* and using reversed horizontal and vertical order (i.e. filling from bottom right to upper left).

[![](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__grid_vertical.png)](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__grid_vertical.png)

## Circle

The *Circle* layout type places UI content in a circle. The circle will be placed at the used *anchor* - you can define the *radius* of the circle and the *degree* the circle uses (e.g. 360 degree for a full circle). The added content can either be distributed evenly on the available degree or placed at fixed offsets (e.g. every 15 degrees).

Here's an example for a 90 degree circle, placed in the *Upper Left*.

[![](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__circle_upper_left.png)](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__circle_upper_left.png)

Here's an example for a full circle (360 degree), placed in the *Middle Center*.

[![](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__circle_middle_center.png)](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__circle_middle_center.png)

Here's an example for a 180 degree circle, placed in the *Lower Center*.

[![](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__circle_lower_center.png)](https://orkframework.com/wp-content/uploads/ork4_section_ui_ui_layouts__circle_lower_center.png)
