TYPO3/RealURL problems

From Aimeos documentation

Other languages:
Deutsch 100% • ‎English 100% • ‎русский 55%

RealUrl provides a possibility to create more readable URLs than the default ones, including the category or product name. When installing the Aimeos TYPO3 extension, RealUrl is among the suggested extensions that you should also install.


You need to have the RealUrl auto-configuration feature enabled to get pretty Aimeos URLs out of the box. If you use your own RealUrl config file, you have to add the rules to your file yourself. In this case use the standard rules as reference which are located in



The most common problem is that you install RealUrl after the Aimeos extension and then, the default RealUrl configuration from Aimeos isn't used and no readable URLs are generated. Make sure that you install RealUrl before installing the Aimeos TYPO3 extension or de-install and re-install the Aimeos TYPO3 extension after you've installed RealUrl. Otherwise, there will be no hint what's wrong und you may be looking at the problem for hours!

Also, you need to delete the file


This file contains the cached RealUrl configuration and is re-created by RealUrl afterwards.

Another problem can be the RealURL path cache stored in the database. In doubt, remove all entries from the tx_realurl_pathcache table in your database.

TYPO3 6.2


The introduction package of TYPO3 6.2 is based on the extension bootstrap_package. It overwrites all custom RealUrl rules from other extensions if you don't disable this behaviour in its extension configuration:

  • Change to ADMIN TOOLS :: Extension Manager in the left navigation of the TYPO3 backend
  • Search for an extension named bootstrap_package
  • Click on its name
  • Uncheck the Use RealUrl Config from BootstrapPackage option
  • Save the changes
  • Flush the caches

TYPO3 6.1


RealUrl version 1.12.7 and before doesn't work correctly in TYPO3 6.1. You are redirected to the 404 page as soon as parameters are in the URL that should be rewritten. The best way to solve the problem is to update RealURL to version 1.12.8 or later. If you are unable to do so, you can disable RealUrl auto-configration in the Aimeos TYPO3 extension:

  • Change to ADMIN TOOLS :: Extension Manager in the left navigation of the TYPO3 backend
  • Search for a the Aimeos extension
  • Click on its name
  • Uncheck the Use auto-configuration for RealUrl option
  • Save the changes
  • Delete the typo3conf/realurl_autoconf.php file

You can create your own static RealURL configuration in the file typo3conf/realurl.conf.php.