---
title: "HBS_NAVIGATION"
manual: "Handlebars"
version: "main"
permalink: "https://docs.typo3.org/permalink/cpsit/typo3-handlebars-forms:co-hbs-navigation@main"
source: "Usage/ContentObjects/Navigation.rst"
rendered: "2026-09-29T09:18:02+00:00"
---

# HBS_NAVIGATION {#co-hbs-navigation}

Resolves the navigation buttons (previous page, next page / submit) for the current
form page. Returns a list of processed items. Each item is built by the sub-configuration
keyed by button role.

**Button roles**

-   `previousPage` – previous-page button (only present when not on the first page)
-   `nextPage` – next-page button (only present when not on the last page)
-   `submit` – submit button (only present on the last page)

Within each role block, `HBS_TAG` and `HBS_LABEL` operate on
the rendered `<button>` tag and the translated button label respectively.

**Example**

```typoscript
navItems = HBS_NAVIGATION
navItems {
    previousPage {
        label = HBS_LABEL

        name = HBS_TAG
        name.attribute = name

        value = HBS_TAG
        value.attribute = value
    }

    nextPage < .previousPage
    submit < .previousPage
}
```