---
title: "Quick Start"
manual: "Grid Elements"
version: "main"
permalink: "https://docs.typo3.org/permalink/gridelementsteam/gridelements:quickstart@main"
source: "Chapters/GettingStarted/QuickStart/Index.rst"
rendered: "2026-11-04T14:20:48+00:00"
---

# Quick Start {#quickstart}

This walkthrough builds one small, real Grid Element: a two-area
structure named *Main* and *Sidebar*. It follows the same sequence any
Grid Element goes through: define a structure, instantiate it, place
content in its areas, and render it. That sequence is
[Structure-first Authoring](https://docs.typo3.org/permalink/gridelementsteam/gridelements:coreconcepts@main), the authoring model
behind Grid Elements; this page demonstrates it rather than explains
it, see [Core Concepts](https://docs.typo3.org/permalink/gridelementsteam/gridelements:coreconcepts@main) for the concept itself.

> [!NOTE]
> This assumes Grid Elements is installed, active, and its
> recommended static template is included, see [Installation](https://docs.typo3.org/permalink/gridelementsteam/gridelements:installation@main).

## Define the grid layout {#define-the-grid-layout}

A grid's structure is TSconfig, not TypoScript, see [TSconfig](https://docs.typo3.org/permalink/gridelementsteam/gridelements:tsconfig@main).
Add the following to the page TSconfig of the page tree this project
works in, either the site's `page.tsconfig` file or, for quick
experimentation, the *Resources* tab of a page's properties:

```typoscript
tx_gridelements.setup.GridElement {
  title = Two-column layout
  config {
    colCount = 2
    rowCount = 1
    rows {
      1 {
        columns {
          1 {
            name = Main
            colPos = 0
          }
          2 {
            name = Sidebar
            colPos = 1
          }
        }
      }
    }
  }
}
```

`title` is what identifies this layout to editors in the backend, it
must be set or the layout will not appear as a choice at all.
`colPos` here is a cell identifier local to this layout, not TYPO3
Core's own `colPos` field, see [Grid TS Syntax](https://docs.typo3.org/permalink/gridelementsteam/gridelements:gridtssyntax@main) for the full
notation and [Data Model](https://docs.typo3.org/permalink/gridelementsteam/gridelements:datamodel@main) for what actually relates a child to its
container. `GridElement`, the identifier this layout is defined
under, is explained below, in [See it render](https://docs.typo3.org/permalink/gridelementsteam/gridelements:see-it-render@main).

This is the same structure the [Grid Wizard](https://docs.typo3.org/permalink/gridelementsteam/gridelements:gridwizard@main) would
produce visually on a CE backend layout database record; either route
defines the same thing, see [Grid Definitions](https://docs.typo3.org/permalink/gridelementsteam/gridelements:griddefinitions@main) for both.

## Create the Grid Element {#create-the-grid-element}

Reload the backend so the new layout is picked up, then open the Page
Module (Web > Page on TYPO3 13, Content > Layout on TYPO3 14) on a
page within reach of that TSconfig. Use the
[Drag-In Wizard](https://docs.typo3.org/permalink/gridelementsteam/gridelements:editorguidedraginwizard@main), the toggle button next
to the Page Module's own *Create new content element* button, find
**Two-column layout** among the Grid Elements offered there, and drag
it into a column. TYPO3's standard
[New Content Element Wizard](https://docs.typo3.org/permalink/gridelementsteam/gridelements:editorguidenewcontentelementwizard@main)
offers the same layout and works just as well; either one creates a
Grid Element with this structure, already placed on the page.

## Fill the structural areas {#fill-the-structural-areas}

The new Grid Element now shows *Main* and *Sidebar* as two areas on
the page, each with its own *Content* control, exactly like an
ordinary page column:

![A Grid Element's structural areas in the Page Module](../../../Images/Installation/CreateGridElements.png)

Add a content element, a simple Text element is enough, to *Main*, and
another to *Sidebar*, the same way content is created anywhere else in
the Page Module.

## See it render {#see-it-render}

Preview the page in the frontend. Both areas already appear, each
showing the content just placed in it, with no template written for
this walkthrough.

That works because of how the recommended static template resolves a
template file: it looks up a Fluid template named after the grid
layout's own identifier, `tx_gridelements.setup.<id>`. Grid Elements
ships one ready-made, generic template under exactly that lookup
mechanism, `GridElement.html`, built to render any row and column
structure without per-layout customization. Naming this walkthrough's
layout identifier `GridElement` is what makes it resolve straight to
that shipped template, so there is nothing left to configure for a
first render. A real project typically gives each layout its own
identifier and, where its rendering should differ, its own template,
see [Rendering Architecture](https://docs.typo3.org/permalink/gridelementsteam/gridelements:renderingarchitecture@main) and [How To](https://docs.typo3.org/permalink/gridelementsteam/gridelements:dataprocessinghowto@main) for how
that resolution works and how to build on it.

## Where to continue {#where-to-continue}

|  |  |
| --- | --- |
| [Grid Definitions](https://docs.typo3.org/permalink/gridelementsteam/gridelements:griddefinitions@main) | The full Grid TS Syntax notation, the Grid Wizard, FlexForm and every TSconfig option used to build a layout like this one. |
| [Restrictions, Validation & Permissions](https://docs.typo3.org/permalink/gridelementsteam/gridelements:restrictions@main) | Limit which content types, and how many, a cell accepts. |
| [Editor Guide](https://docs.typo3.org/permalink/gridelementsteam/gridelements:editorguide@main) | Day-to-day authoring: the Page Module, drag and drop, both wizards, references and localization. |
| [Rendering](https://docs.typo3.org/permalink/gridelementsteam/gridelements:rendering@main) | The rendering architecture, `GridChildrenProcessor` in depth, and its full option reference. |
| [Data Model](https://docs.typo3.org/permalink/gridelementsteam/gridelements:datamodel@main) | The parent-child relation, nesting and the data actually stored behind what was just built. |
