#108915Page Creation Wizard
Description
Our current page creation workflow is a barrier to entry for new editors. It is technically complex, not mobile-ready, and fails to guarantee data integrity, resulting in a slow and frustrating ‘time-to-content’ experience.
Our goal is to streamline the page creation process by introducing a guided, accessible, and error-proof wizard that empowers editors to build high-quality page structures without requiring deep technical knowledge.
Goals
Data Integrity and Content Readiness
We want to ensure that all mandatory fields are populated during page creation so that we avoid “broken” or incomplete page records (e.g. missing configurations for news detail pages).
Key Points:- Validation of required fields during the creation step.
Intuitive and Guided User Experience
Editors should get a consistent and guided process for creating pages to achieve results quickly without having to navigate complex TYPO3-specific settings.
Key Points:- Fast-track to results, avoid unnecessary steps.
- Standardized workflow for all page types.
- Zero TYPO3-specific expertise required for basic setup.
Accessibility and Responsive Design
We want to build pages using an interface that follows accessibility guidance and modern web standards.
Key Points:- WCAG 2.2-compliant accessibility for the entire wizard workflow.
- Responsive layout.
Workflow Flexibility and Efficiency
It should be possible to start the wizard from different entry points in the backend, with pre-defined parameters depending on context. Creating multiple pages should also be supported.
Examples:- Current Drag&Drop behavior would pre-fill the page type and position.
- Creating a page from the Records module would pre-fill the position property.
- Wizard can be repeated, instead of finishing, “Create New Page”, to support a workflow of creating multiple pages.
- Context-aware start (Wizard respects pre-selected positions or types).
Extensibility and Modularity
The page creation wizard should be modular and extensible, so that integrators can implement custom steps for their own page types or extend existing ones.
Key Points:- The concept “page creation wizard” should be implemented generic enough to later be adopted to improve further TYPO3 workflows (e.g., content element creation).
- Developers should be able to extend existing configuration, but not be able to remove required steps defined by the TYPO3 Core.
Technical Concept: Frontend/User
frontend-user-page-creation-flow-compact.png
Initialization and Type Selection
The process begins with the initialization of the Wizard UI, triggered via different actions in the Backend, the prototype suggesting a new button in the page tree actions. In the first step, the system fetches all available Page Types (doktype) through a fetch request to a JSON endpoint. This ensures that only relevant types, including custom icons and labels, are presented to the user. Once a type is selected, a frontend validation check confirms the choice before moving forward.
Dynamic Content Loading
Upon proceeding, the Wizard sends the selected doktype to the server to determine the specific requirements for the following steps. The goal is to receive a server-side rendered form using the TYPO3 FormEngine. This approach ensures that all TCA-based rules and field configurations are respected.
Positioning and Page Tree Integration
The second step presents a page tree to the user. This allows the user to select an origin and define the exact position, such as “above page”, “below page” or “as subpage”.
Data Entry and Validation
The subsequent steps gather the actual page information, divided into required fields and optional/recommended fields + additional steps. Required fields like the page title and URL slug are handled first, followed by optional metadata or SEO settings. Each transition between these steps is protected by frontend validation to ensure that all mandatory fields are correctly filled according to TCA requirements.
Review and Persistence
Before any data is written to the database, a summary screen provides an overview of all entries. This allows the user to verify the page type, position, and values at a glance. Once confirmed, the data is transmitted to the the TYPO3 DataHandler to create the record, ensuring that all system hooks and permission checks are properly executed.
Success Feedback and Workflow
The final step informs the user of a successful creation through a clear feedback message. Instead of simply closing the Wizard, the UI offers contextual follow-up actions. The user can choose to jump directly into the Layout Module to add content, start the process over to create another page, or exit the Wizard to return to their previous task.
Technical Concept: Backend
Naming of the class and method names below is not final and open to discussion.
- A generic WizardController will be called as soon as initial data is requested.
- The controller will be generic, wizard specific logic is to be implemented in WizardProvider classes.
- Initial data can be anything, in the case of the Page Creation Wizard its the available page types.
Design Pattern:
The generic WizardController has three endpoints. Each endpoint gets passed the wizard type, which is internally resolved to a WizardProvider implementation
Endpoints:- Fetching initial data
- Fetching wizard steps
- Persisting wizard result
- WizardProviders are resolved using a WizardProviderFactory that gets the requested type passed from the controller
- The WizardProviders should be tagged with an Attribute that allows the factory to resolve them, e.g.
#[AsWizardProvider(wizard: 'page-creation')]
- Initial data request returns all available page types and their count of steps for the wizard.
- Wizard step resolving:
- One wizard step returns all required fields (fields marked as required in TCA)
- Another wizard step returns all recommended fields (fields marked as recommended in TCA)
- Markup of these steps should be rendered with FormEngine.
- Persistance step:
- Resulting page data should be persisted via DataHandler.
See:
!initialData.png!
!getSteps.png!
persist.png
Reviews 42
- main 93369[FEATURE] Allow extending page creation wizard steps using events
- main 93366[TASK] Improve error handling and generalize Localization Wizard
- 14.3 95527[TASK] Add E2E tests for page creation via page wizard
- main 93319[TASK] Add E2E tests for page creation via page wizard
- 14.3 94613[TASK] Mark shortcut as required if shortcut_mode=0
- main 93021[TASK] Mark shortcut as required if shortcut_mode=0
- main 93065[!!!][TASK] Remove obsolete pages-only new record route
- main 93364[TASK] Allow bulk creation of page doktypes that require title only
- main 93329[TASK] Integrate wizard step configuration into tca schema
- main 93368[BUGFIX] Show previous form values in page creation wizard
- main 93346[TASK] Merge form-engine page wizard data before submitting
- main 93316[TASK] Add permission checks to PageWizardController
- main 93396[TASK] Correct misleading success messages in page, form, and localization wizards
- main 93394[BUGFIX] Reload page tree after page creation via page wizard
- main 93370[TASK] Show a no-result indicator in page wizard doktype search
- main 93286[TASK] Respect doktype grouping in page wizard
- main 93362[BUGFIX] Fix stale values in page creation wizard confirmation step
- main 93290[FEATURE] Implement page creation wizard
- main 93349[TASK] Respect label overrides in page wizard
- main 93336[BUGFIX] Protect step methods when loading dynamic wizard steps
- main 93320[TASK] Use functional tests for page wizard controllers
- main 93334[TASK] Add comments for page creation wizard components
- main 93337[BUGFIX] Avoid multiple FormEngine delegates in page creation wizard
- main 93330[BUGFIX] Fix LinkBrowser usage in page creation wizard
- main 93331[TASK] Define allowed HTTP methods for page wizard endpoints
- main 93325[TASK] Lazily instantiate wizard providers
- main 93310[TASK] Use default style for "+ Page" button in page tree
- main 93314[BUGFIX] fix page wizard typos, naming, style, unused functions
- main 92961[FEATURE] Add page-position-select component with page insertion options
- main 93003[WIP][FEATURE] Add page-position-select component with page insertion options (after & inside on node select)
- main 92898[FEATURE] Add client-side page wizard scaffold with start button
- main 93174[FEATURE] Add TCA configuration for dynamic page creation wizard steps
- main 93004[FEATURE] Add page-position-select component with insertion options
- main 92755[FEATURE] Provide an option to configure TCA fields as recommended
- main 93149[TASK] Restructure Toolbar Submenu in TYPO3 page tree
- main 92923[FEATURE] Enable condition-based configuration of fields as required
- main 93139[TASK] Use FormDataCompiler in NewMultiplePagesController
- main 93085[TASK] Refactor field items processing into dedicated service
- main 93081[BUGFIX] Forms Wizard: Auto-focus `newFormName` in settings step
- main 92869[TASK] Use typo3-backend-wizard component in form wizard
- main 92821[TASK] Extract generic wizard component from LocalizationWizard for reuse
- main 92826[WIP][TASK] Use generic wizard component for form wizard
Subtasks 43
- Task #108916Add new TCA option recommended fields
- Bug #108918Make “Create new page” action in page tree accessible for screen readers
- Task #108936LocalizationWizard Refactoring
- Feature #108937Enable configuring field dependencies in TCA
- Feature #108938Allow overriding recommended TCA fields using pagets
- Task #108978Separate compiling and asset handling concerns of FormEngine
- Feature #109024Create scaffold for client-side Page Wizard implementation
- Task #109029Remove doSave hidden field from FormEngine
- Feature #109031Web Component `typo3-backend-component-page-position-select`
- Epic #109064JavaScript Label API
- Task #109124Mark recommended fields on validation
- Task #109153Cleanup: Remove obsolete routes, controllers, and templates after introduction of the PageWizard
- Bug #109161Form Wizard: Auto focus `newFormName` text input in settings step
- Task #109164Refactor TCA Field Items Filtering into Dedicated Service
- Task #109196Restructure Toolbar Submenu in TYPO3 page tree
- Feature #109271Make wizard steps configurable
- Task #109299Respect doktype grouping
- Task #109303Improve Wizard steps with a "Quick Finish" / "Fast Forward" / "Accept defaults" / ... methodology
- Task #109318Adjust styling of “+ Page” button
- Bug #109322Follow-up: Fix typos & improve wording & remove unusued functions
- Task #109324Add permission checks to PageWizardController
- Task #109328Follow-up: Replace unit tests with functional tests for Wizard Controller
- Task #109336Register Wizard providers using php Attribute
- Task #109337Integrate Tca configuration wizard steps in TCA schema
- Task #109339Add missing E2E tests for page creation via page wizard
- Task #109344Respect Tsconfig overrides when building page wizard steps
- Task #109345Define allowed HTTP methods for PageWizard endpoints
- Task #109347Add Documentation for Page Creation Wizard Components
- Bug #109349Safe dynamic assignment for dynamic steps to protect methods
- Task #109356Properly submit page wizard form
- Task #109359Respect Tsconfig overrides when resolving page wizard field labels
- Bug #109376Page Creation Wizard: Summary shows stale field values after editing (e.g., title)
- Task #109382Page Wizard: Show No Results Message in Page Type Step
- Feature #109383Allow overriding wizard steps
- Task #109387Streamline Wizard error handling
- Bug #109397Page tree not reloading after page creation flow
- Task #109399Update misleading success messages in wizards
- Bug #109405Page creation wizard does not show values when navigating back to previous steps
- Task #109417Allow advancing form steps in page creation wizard using Enter key
- Task #109422Allow bulk creation of page doktypes that require title only
- Bug #109425Element Browser does not write values into page creation wizard
- Bug #109426Enhance keyboard usability by maintaining/reapplying focus after wizard step change
- Bug #110125Not possible to add files in page creation wizard
Related issues 6
- Task #107260Introduce mutable TCA Schema for FormEngine with backwards compatibility to processedTca
- Bug #109013Incorrect Redirect After Finishing Localization Wizard
- Bug #109066Page Browser does not visually preselect active page
- Bug #109117Page Browser tree does not preselect current page if parent nodes are collapsed/not loaded
- Bug #109353LinkBrowser does not write values into page wizard
- Bug #109354Page creation wizard actions trigger multiple times
Files 4
History 6068
Show 3543 earlier messages
-
Bastien Lutz changed Related to #108916 <span data-processor="relativetime" data-value="2026-02-09T14:22:08+00:00" > 02/09/26, 14:22 </span>
-
Garvin Hicking changed subtask #108918 <span data-processor="relativetime" data-value="2026-02-09T19:42:12+00:00" > 02/09/26, 19:42 </span>
-
Andreas Nedbal changed attached frontend-user-page-creation-flow-compact.png description <span data-processor="relativetime" data-value="2026-02-10T14:36:22+00:00" > 02/10/26, 14:36 </span>
-
Benjamin Kott changed subtask #108916 <span data-processor="relativetime" data-value="2026-02-11T07:43:07+00:00" > 02/11/26, 07:43 </span>
-
Tobias Wojtylak changed subtask #108936 <span data-processor="relativetime" data-value="2026-02-11T07:56:04+00:00" > 02/11/26, 07:56 </span>
-
Bastien Lutz changed subtask #108937 <span data-processor="relativetime" data-value="2026-02-11T08:19:51+00:00" > 02/11/26, 08:19 </span>
-
Bastien Lutz changed subtask #108938 <span data-processor="relativetime" data-value="2026-02-11T08:21:57+00:00" > 02/11/26, 08:21 </span>
-
Andreas Nedbal changed description <span data-processor="relativetime" data-value="2026-02-11T11:05:10+00:00" > 02/11/26, 11:05 </span>
-
Tobias Wojtylak changed subtask #108941 <span data-processor="relativetime" data-value="2026-02-11T11:54:28+00:00" > 02/11/26, 11:54 </span>
-
Bastien Lutz changed attached persist.png attached getSteps.png attached initialData.png description <span data-processor="relativetime" data-value="2026-02-11T12:40:12+00:00" > 02/11/26, 12:40 </span>
-
Andreas Nedbal changed description <span data-processor="relativetime" data-value="2026-02-11T13:58:11+00:00" > 02/11/26, 13:58 </span>
-
Andreas Nedbal changed subtask #108978 <span data-processor="relativetime" data-value="2026-02-13T15:46:22+00:00" > 02/13/26, 15:46 </span>
-
Tobias Wojtylak changed subtask #109024 <span data-processor="relativetime" data-value="2026-02-19T14:00:59+00:00" > 02/19/26, 14:00 </span>
-
Benjamin Kott changed Related to #109006 <span data-processor="relativetime" data-value="2026-02-19T15:01:40+00:00" > 02/19/26, 15:01 </span>
-
Benjamin Kott changed subtask #109029 <span data-processor="relativetime" data-value="2026-02-19T23:58:16+00:00" > 02/19/26, 23:58 </span>
-
Tobias Wojtylak changed subtask #109031 <span data-processor="relativetime" data-value="2026-02-20T08:15:32+00:00" > 02/20/26, 08:15 </span>
-
Benjamin Franzke changed Related to #109064 <span data-processor="relativetime" data-value="2026-02-23T07:58:31+00:00" > 02/23/26, 07:58 </span>
-
Bastien Lutz changed Related to #107260 <span data-processor="relativetime" data-value="2026-02-23T07:58:32+00:00" > 02/23/26, 07:58 </span>
-
Benjamin Franzke changed subtask #109064 <span data-processor="relativetime" data-value="2026-02-23T07:59:17+00:00" > 02/23/26, 07:59 </span>
-
Benjamin Franzke changed
subtask #108941<span data-processor="relativetime" data-value="2026-02-23T08:00:04+00:00" > 02/23/26, 08:00 </span> -
Tobias Wojtylak changed Related to #109066 <span data-processor="relativetime" data-value="2026-02-23T08:04:41+00:00" > 02/23/26, 08:04 </span>
-
Tobias Wojtylak changed Related to #109013 <span data-processor="relativetime" data-value="2026-02-23T08:47:11+00:00" > 02/23/26, 08:47 </span>
-
Tobias Wojtylak changed Related to #109117 <span data-processor="relativetime" data-value="2026-02-27T08:54:45+00:00" > 02/27/26, 08:54 </span>
-
Bastien Lutz changed subtask #109124 <span data-processor="relativetime" data-value="2026-03-02T08:46:28+00:00" > 03/02/26, 08:46 </span>
-
Tobias Wojtylak changed subtask #109153 <span data-processor="relativetime" data-value="2026-03-04T13:58:38+00:00" > 03/04/26, 13:58 </span>
-
Tobias Wojtylak changed subtask #109161 <span data-processor="relativetime" data-value="2026-03-05T08:40:17+00:00" > 03/05/26, 08:40 </span>
-
Tobias Wojtylak changed subtask #109164 <span data-processor="relativetime" data-value="2026-03-05T11:11:49+00:00" > 03/05/26, 11:11 </span>
-
Tobias Wojtylak changed subtask #109196 <span data-processor="relativetime" data-value="2026-03-10T08:52:23+00:00" > 03/10/26, 08:52 </span>
-
Bastien Lutz changed subtask #109271 <span data-processor="relativetime" data-value="2026-03-17T10:38:32+00:00" > 03/17/26, 10:38 </span>
-
Bastien Lutz changed subtask #109299 <span data-processor="relativetime" data-value="2026-03-20T09:46:32+00:00" > 03/20/26, 09:46 </span>
-
Garvin Hicking changed subtask #109303 <span data-processor="relativetime" data-value="2026-03-20T12:22:34+00:00" > 03/20/26, 12:22 </span>
-
Gerrit Code Review pushed patch set 1 for main to change 93290 status
NewUnder Review <span data-processor="relativetime" data-value="2026-03-20T13:44:08+00:00" > 03/20/26, 13:44 </span> -
Gerrit Code Review pushed patch set 2 for main to change 93290 <span data-processor="relativetime" data-value="2026-03-20T13:52:05+00:00" > 03/20/26, 13:52 </span>
-
Gerrit Code Review pushed patch set 3 for main to change 93290 <span data-processor="relativetime" data-value="2026-03-20T14:13:07+00:00" > 03/20/26, 14:13 </span>
-
Gerrit Code Review pushed patch set 4 for main to change 93290 <span data-processor="relativetime" data-value="2026-03-20T14:39:53+00:00" > 03/20/26, 14:39 </span>
-
Gerrit Code Review pushed patch set 5 for main to change 93290 <span data-processor="relativetime" data-value="2026-03-20T14:41:04+00:00" > 03/20/26, 14:41 </span>
-
Gerrit Code Review pushed patch set 6 for main to change 93290 <span data-processor="relativetime" data-value="2026-03-23T06:30:06+00:00" > 03/23/26, 06:30 </span>
-
Gerrit Code Review pushed patch set 7 for main to change 93290 <span data-processor="relativetime" data-value="2026-03-23T06:38:12+00:00" > 03/23/26, 06:38 </span>
-
Gerrit Code Review pushed patch set 8 for main to change 93290 <span data-processor="relativetime" data-value="2026-03-23T07:10:34+00:00" > 03/23/26, 07:10 </span>
-
Florian Keitgen commented and changed status
Under ReviewResolved done54 %100 % <span data-processor="relativetime" data-value="2026-03-23T07:55:11+00:00" > 03/23/26, 07:55 </span> -
Benjamin Kott changed status
ResolvedIn Progress <span data-processor="relativetime" data-value="2026-03-23T08:56:41+00:00" > 03/23/26, 08:56 </span> -
Tobias Wojtylak changed subtask #109318 <span data-processor="relativetime" data-value="2026-03-23T08:57:02+00:00" > 03/23/26, 08:57 </span>
-
Tobias Wojtylak changed subtask #109322 <span data-processor="relativetime" data-value="2026-03-23T10:52:06+00:00" > 03/23/26, 10:52 </span>
-
Andreas Nedbal changed subtask #109324 <span data-processor="relativetime" data-value="2026-03-23T12:51:41+00:00" > 03/23/26, 12:51 </span>
-
Tobias Wojtylak changed subtask #109328 <span data-processor="relativetime" data-value="2026-03-23T15:10:05+00:00" > 03/23/26, 15:10 </span>
-
Bastien Lutz changed subtask #109336 <span data-processor="relativetime" data-value="2026-03-24T08:51:04+00:00" > 03/24/26, 08:51 </span>
-
Bastien Lutz changed subtask #109337 <span data-processor="relativetime" data-value="2026-03-24T09:30:29+00:00" > 03/24/26, 09:30 </span>
-
Tobias Wojtylak changed subtask #109339 <span data-processor="relativetime" data-value="2026-03-24T10:41:24+00:00" > 03/24/26, 10:41 </span>
-
Bastien Lutz changed subtask #109344 <span data-processor="relativetime" data-value="2026-03-24T14:34:41+00:00" > 03/24/26, 14:34 </span>
-
Tobias Wojtylak changed subtask #109345 <span data-processor="relativetime" data-value="2026-03-24T14:35:06+00:00" > 03/24/26, 14:35 </span>
-
Tobias Wojtylak changed subtask #109347 <span data-processor="relativetime" data-value="2026-03-24T14:49:23+00:00" > 03/24/26, 14:49 </span>
-
Tobias Wojtylak changed subtask #109349 <span data-processor="relativetime" data-value="2026-03-24T16:09:33+00:00" > 03/24/26, 16:09 </span>
-
Benjamin Franzke changed Related to #109353 <span data-processor="relativetime" data-value="2026-03-25T08:14:28+00:00" > 03/25/26, 08:14 </span>
-
Benjamin Franzke changed Related to #109354 <span data-processor="relativetime" data-value="2026-03-25T08:19:33+00:00" > 03/25/26, 08:19 </span>
-
Bastien Lutz changed subtask #109356 <span data-processor="relativetime" data-value="2026-03-25T09:59:54+00:00" > 03/25/26, 09:59 </span>
-
Bastien Lutz changed subtask #109359 <span data-processor="relativetime" data-value="2026-03-25T12:05:20+00:00" > 03/25/26, 12:05 </span>
-
Tobias Wojtylak changed subtask #109376 <span data-processor="relativetime" data-value="2026-03-26T08:47:42+00:00" > 03/26/26, 08:47 </span>
-
Tobias Wojtylak changed subtask #109382 <span data-processor="relativetime" data-value="2026-03-26T14:43:52+00:00" > 03/26/26, 14:43 </span>
-
Bastien Lutz changed subtask #109383 <span data-processor="relativetime" data-value="2026-03-26T14:54:13+00:00" > 03/26/26, 14:54 </span>
-
Tobias Wojtylak changed subtask #109387 <span data-processor="relativetime" data-value="2026-03-26T15:42:21+00:00" > 03/26/26, 15:42 </span>
-
Tobias Wojtylak changed subtask #109397 <span data-processor="relativetime" data-value="2026-03-27T09:08:14+00:00" > 03/27/26, 09:08 </span>
-
Tobias Wojtylak changed subtask #109399 <span data-processor="relativetime" data-value="2026-03-27T11:04:02+00:00" > 03/27/26, 11:04 </span>
-
Benjamin Franzke changed subtask #109405 <span data-processor="relativetime" data-value="2026-03-27T13:58:26+00:00" > 03/27/26, 13:58 </span>
-
Andreas Nedbal changed subtask #109417 <span data-processor="relativetime" data-value="2026-03-30T10:11:16+00:00" > 03/30/26, 10:11 </span>
-
Benjamin Franzke changed subtask #109422 <span data-processor="relativetime" data-value="2026-03-30T11:27:48+00:00" > 03/30/26, 11:27 </span>
-
Benjamin Franzke changed subtask #109425 <span data-processor="relativetime" data-value="2026-03-30T12:46:16+00:00" > 03/30/26, 12:46 </span>
-
Benjamin Franzke changed subtask #109426 <span data-processor="relativetime" data-value="2026-03-30T14:57:10+00:00" > 03/30/26, 14:57 </span>
-
Garvin Hicking changed subtask #110125 <span data-processor="relativetime" data-value="2026-06-30T17:21:09+00:00" > 06/30/26, 17:21 </span>
Applied in changeset commit:24e5e394d3ba9ef80e85a6763c69f871fd40aacf.