---
title: "wizards"
manual: "TypoScript Explained"
version: "13.4"
permalink: "https://docs.typo3.org/permalink/t3tsref:page-mod-wizard@13.4"
source: "PageTsconfig/Mod/Wizards.rst"
rendered: "2026-09-28T13:42:24+00:00"
---

# wizards {#page-mod-wizard}

The `wizards` section allows to customize the *New record wizard* and the
*New content element wizard*.

-   [newContentElement.wizardItems](https://docs.typo3.org/permalink/t3tsref:newcontentelement-wizarditems@13.4)
-   [newRecord.order](https://docs.typo3.org/permalink/t3tsref:newrecord-order@13.4)
-   [newRecord.pages](https://docs.typo3.org/permalink/t3tsref:newrecord-pages@13.4)

## newContentElement.wizardItems {#pagenewcontentelementwizard}

<!-- TODO: no Markdown rendering for "versionchanged" -->

New content elements added via TCA to the
items of field CType
of table tt_content are automatically added to the New Content Element
Wizard. The following page TSconfig can be used to override values set via
TCA.

**newContentElement.wizardItems**

-   **newContentElement.wizardItems**

    -   *Type:* array
    -   *Page TSconfig path:* mod.wizards.newContentElement.wizardItems

    In the New Content Element Wizard, content element types are grouped
    together by type. Each such group can be configured independently. The
    four default groups are: `default`, `special`, `forms` and `plugins`.

    <!-- TODO: no Markdown rendering for "versionchanged" -->

    The group common was renamed to default. A permanent migration is in
    place.**removeItems**

    -   **removeItems**

        -   *Type:* comma separated list of groups
        -   *Page TSconfig path:* mod.wizards.newContentElement.wizardItems.removeItems

        <!-- TODO: no Markdown rendering for "versionchanged" -->

        With this setting one or several groups with all their content
        elements can be hidden in the New Content Element Wizard.

        ```typoscript
        # This will remove the "menu" group
        mod.wizards.newContentElement.wizardItems.removeItems := addToList(menu)
        ```

    **\[group\].before**

    -   **\[group\].before**

        -   *Type:* string
        -   *Page TSconfig path:* mod.wizards.newContentElement.wizardItems.\[group\].before

        Sorts \[group\] in front of the group given.

    **\[group\].after**

    -   **\[group\].after**

        -   *Type:* string
        -   *Page TSconfig path:* mod.wizards.newContentElement.wizardItems.\[group\].after

        Sorts \[group\] after the group given.

    **\[group\].header**

    -   **\[group\].header**

        -   *Type:* plain text label or [label reference](https://docs.typo3.org/permalink/t3coreapi:label-reference)
        -   *Page TSconfig path:* mod.wizards.newContentElement.wizardItems.\[group\].header

        Name of the group.

    **\[group\].show**

    -   **\[group\].show**

        -   *Type:* string, comma-separated list of items
        -   *Page TSconfig path:* mod.wizards.newContentElement.wizardItems.\[group\].show

        <!-- TODO: no Markdown rendering for "versionchanged" -->

        The configuration of the New Content Element Wizard has been
        changed to automatically registering the groups and elements
        from the TCA configuration.The previously used option to show / hide elements
        mod.wizards.newContentElement.wizardItems.<group>.show is
        not evaluated anymore.All configured groups and elements are automatically shown. Removing these
        groups and elements from the New Content Element Wizard can be done via
        the option removeItems and
        [group].removeItems
        options.

    **\[group\].elements**

    -   **\[group\].elements**

        -   *Type:* array
        -   *Page TSconfig path:* mod.wizards.newContentElement.wizardItems.\[group\].elements

        List of items in the group.

        **\[name\]**

        -   **\[name\]**

            -   *Type:* array
            -   *Page TSconfig path:* mod.wizards.newContentElement.wizardItems.\[group\].elements.\[name\]

            Configuration for a single item.

            **iconIdentifier**

            -   **iconIdentifier**

                -   *Type:* string
                -   *Page TSconfig path:* mod.wizards.newContentElement.wizardItems.\[group\].elements.\[name\].iconIdentifier

                The icon identifier of the icon you want to display.

            **iconOverlay**

            -   **iconOverlay**

                -   *Type:* string
                -   *Page TSconfig path:* mod.wizards.newContentElement.wizardItems.\[group\].elements.\[name\].iconOverlay

                The icon identifier of the overlay icon you want to use.

            **title**

            -   **title**

                -   *Type:* plain text label or [label reference](https://docs.typo3.org/permalink/t3coreapi:label-reference)
                -   *Page TSconfig path:* mod.wizards.newContentElement.wizardItems.\[group\].elements.\[name\].title

                Name of the item.

            **description**

            -   **description**

                -   *Type:* plain text label or [label reference](https://docs.typo3.org/permalink/t3coreapi:label-reference)
                -   *Page TSconfig path:* mod.wizards.newContentElement.wizardItems.\[group\].elements.\[name\].description

                Description text for the item.

            **tt_content_defValues**

            -   **tt_content_defValues**

                -   *Type:* array
                -   *Page TSconfig path:* mod.wizards.newContentElement.wizardItems.\[group\].elements.\[name\].tt_content_defValues

                Default values for tt_content fields.

            **saveAndClose**

            -   **saveAndClose**

                -   *Type:* bool
                -   *Default:* `false`
                -   *Page TSconfig path:* mod.wizards.newContentElement.wizardItems.\[group\].elements.\[name\].saveAndClose

                If `true`, directs the user back to the **Page** module
                directly instead of showing the FormEngine.

    **\[group\].removeItems**

    -   **\[group\].removeItems**

        -   *Type:* Comma separated list
        -   *Page TSconfig path:* mod.wizards.newContentElement.wizardItems.\[group\].removeItems

        <!-- TODO: no Markdown rendering for "versionchanged" -->

        Comma separated list of content elements that should be hidden in
        \[group\].

        **EXT:site_package/Configuration/page.tsconfig**

        ```typoscript
        mod.wizards.newContentElement.wizardItems {
            special.removeItems := addToList(html)
        }
        ```

### Example: Add a new element to the "common" group {#pageexample1}

**EXT:site_package/Configuration/page.tsconfig**

```typoscript
# Add a new element (header) to the "common" group
mod.wizards.newContentElement.wizardItems.common.elements.header {
  iconIdentifier = content-header
  title = Header
  description = Adds a header element only
  tt_content_defValues {
    CType = header
  }
}
mod.wizards.newContentElement.wizardItems.common.show := addToList(header)

```

### Example: Create a new group and add an element to it {#pageexample2}

**EXT:site_package/Configuration/page.tsconfig**

```typoscript
# Create a new group and add a (pre-filled) element to it
mod.wizards.newContentElement.wizardItems.myGroup {
  header = LLL:EXT:cms/layout/locallang.xlf:advancedFunctions
  elements.customText {
    iconIdentifier = content-text
    title = Introductory text for national startpage
    description = Use this element for all national startpages
    tt_content_defValues {
      CType = text
      bodytext (
                    <h2>Section Header</h2>
                    <p class="bodytext">Lorem ipsum dolor sit amet, consectetur, sadipisci velit ...</p>
            )
      header = Section Header
      header_layout = 100
    }
  }
}
mod.wizards.newContentElement.wizardItems.myGroup.show = customText

```

With the second example, the bottom of the new content element wizard shows:

![Added entry in the new content element wizard](../../Images/ManualScreenshots/List/PageTsModWizardsNewContentElementExample2.png)

## newRecord.order {#mod-wizards-newrecord-order}

-   **newRecord.order**

    -   *Type:* list of values

    Define an alternate order for the groups of records in the new records
    wizard. Pages and content elements will always be on top, but the
    order of other record groups can be changed.

    Records are grouped by extension keys, plus the special key "system"
    for records provided by the TYPO3 Core.

### Example: Place the tt_news group at the top of the new record dialog {#mod-wizards-newrecord-order-example}

Place the tt_news group at the top (after pages and content
elements), other groups follow unchanged:

**EXT:site_package/Configuration/page.tsconfig**

```typoscript
mod.wizards.newRecord.order = tt_news
```

![The position of News changed after modifying the New record screen](../../Images/ManualScreenshots/List/NewRecordWizardNewOrder.png)

## newRecord.pages {#mod-wizards-newrecord-pages}

-   **newRecord.pages**

    -   *Type:* boolean

    Use the following sub-properties to show or hide the specified links.
    Setting any of these properties to 0 will hide the corresponding link,
    but setting to 1 will leave it visible.

    -   **show.pageAfter**

        Show or hide the link to create new pages after the selected page.

    -   **show.pageInside**

        Show or hide the link to create new pages inside the selected page.

    -   **show.pageSelectPosition**

        Show or hide the link to create new pages at a selected position.

### Example: Hide the "Page (inside)" link in the "New Record" dialog {#mod-wizards-newrecord-pages-example}

**EXT:site_package/Configuration/page.tsconfig**

```typoscript
mod.wizards.newRecord.pages.show {
  # Hide the "Page (inside)" link.
  pageInside = 0
}

```

![The modified New record screen without Page (inside)](../../Images/ManualScreenshots/List/PageTsModWizardsNewRecordHideInside.png)