---
title: Extbase Routing, Finally Explained — and the Docs Keep Growing
url: "https://news.typo3.com/article/extbase-routing-finally-explained-and-the-docs-keep-growing"
description: The Extbase documentation overhaul continues. Anja Leichsenring shares a second update.
image: "https://news.typo3.com/_assets/d1e01514e4c4a5b3147940fa2ec50682/Images/og-image-news.jpg"
date: 2026-07-06
modified: 2026-07-07
categories:
  - "Developer & Technology"
---

# Extbase Routing, Finally Explained — and the Docs Keep Growing

- [Developer & Technology](https://news.typo3.com/article/category/developer-technology)

Extbase Routing, Finally Explained — and the Docs Keep Growing
==============================================================

06 July 2026

![A computer screen displays TYPO3 documentation titled “Routing for Extbase plugins,” with sample URL code and explanations about readable, SEO-friendly URLs. The navigation menu appears on the left side.](https://news.typo3.com/fileadmin/_processed_/1/5/csm_Routing_for_Extbase_Plugins_82523af898.webp)

The Extbase documentation is being improved. Anja Leichsenring shares an update on this ongoing work.

- ![](https://news.typo3.com/typo3temp/assets/t3g/blog/gravatar/f29da8d5bb7109434e07310f4f754385.jpeg)[Anja Leichsenring](https://news.typo3.com/article/author/anja-leichsenring)

A few weeks ago, I [reported](https://news.typo3.com/article/extbase-documentation-overhaul-status-report) that the rebuilt [Extbase documentation](https://docs.typo3.org/permalink/t3coreapi:extension-development) was online and growing. Since then, the chapter people have asked for most has landed.

 Routing Is Live
-----------------

Extbase routing is where a lot of developers get stuck and the new [Routing chapter](https://docs.typo3.org/permalink/t3coreapi:extbase-routing) comes to the rescue. It walks the whole path from a clean URL back to a controller action—the plugin enhancer, route paths and arguments, and the mappers that turn a slug into a record.

It contains examples and a [Common Mistakes section](https://docs.typo3.org/permalink/t3coreapi:extbase-routing-examples-mistakes), built from the questions that come up again and again. If you have ever fought with `routeEnhancers` and given up, this is the chapter to read.

 What Else Is New
------------------

Routing did not arrive alone.

- **The** [**Validation chapter**](https://docs.typo3.org/permalink/t3coreapi:extbase-validation-overview) is online, along with file uploads in the [domain model](https://docs.typo3.org/permalink/t3coreapi:extbase-domain-fileupload).
- **The first parts of** [**Persistence**](https://docs.typo3.org/permalink/t3coreapi:extbase-persistence-overview) have landed too: how to build a query, and how relations really work behind the scenes.
- [**Configuration**](https://docs.typo3.org/permalink/t3coreapi:extbase-configuration) **is covered** as well, including the parts that are not TypoScript.

 What Comes Next
-----------------

**The funded work runs until the end of August.** Still to come: the rest of Persistence, the Caching chapter, and a chapter on hardening frontend plugins. Caching carries a message worth repeating early: switch off the cache, and performance becomes your responsibility.

 One Thing You Can Do
----------------------

This documentation gets better when it reflects real-world pain. If Extbase has ever surprised you — a stubborn `cHash` that keeps breaking your URLs, a relation that would not save — tell us. [Open an issue](https://github.com/TYPO3-Documentation/TYPO3CMS-Reference-CoreApi/issues/new/choose) or a pull request, and it might become an entry on the list of [common pitfalls](https://docs.typo3.org/permalink/t3coreapi:extbase-appendix-pitfalls) that saves the next developer a day of work.

This work to [overhaul the Extbase documentation](https://talk.typo3.org/t/team-idea-extbase-documentation-overhaul-modern-best-practices-for-typo3-v14-lina-wolf-documentation-team/6589) is a community budget idea [funded by the TYPO3 Association on behalf of its members](https://news.typo3.com/article/members-have-selected-four-ideas-to-be-funded-in-round-two-2026). Thank you for voting for it.

![](https://news.typo3.com/typo3temp/assets/t3g/blog/gravatar/f00b6176fd88a64d0f5d0acfe1470b0b.jpeg)

About the Author

[Anja Leichsenring](https://news.typo3.com/article/author/anja-leichsenring)

TYPO3 Developer

Hi, I'm Anja, working with and on TYPO3 since 2005. My focus is in backend, I favour clean architecture, green tests (many of 'em) and easy upgrade paths. Also, I care for happy people doing great work and in-person events to get to know each other better.

[More posts by this author](https://news.typo3.com/article/author/anja-leichsenring)