Attention

TYPO3 v10 has reached end-of-life as of April 30th 2023 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.

Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v10 here: TYPO3 ELTS.

Page based Routing

TYPO3 allows page based routing (that is mapping pages to routes) out of the box.

Configuration

To enable page based routing, add a site configuration (see Site Handling) for your web site. To see which route gets mapped to which page, open the page properties and look at the slug field.

Hint

To enable editors to change the slug (or update the slug when they change the page title for example) make sure that your editor groups have access to the slug field.

How a page slug is generated is configured via TCA configuration of the pages table (field slug). You can adjust that configuration in your extensions' TCA/Overrides/pages.php. See TCA reference (see type = 'slug' for available options).

Upgrading

An upgrade wizard has been provided that will take care of generating slugs for all existing pages. If you used RealURL before, the wizard tries to use the RealURL caches to generate matching slugs. However, this will not be successful in all cases and you should recheck the generated slugs if you want the URL structure to stay the same after an upgrade.