The SpecialRouter module adds the ability to use special characters in URLs.

2.0.0 2024-04-13 14:38 UTC

This package is auto-updated.

Last update: 2024-06-13 15:12:38 UTC


Adds the ability to use special characters in URLs.

Supported Magento Versions Latest Stable Version Composer Downloads Maintained - Yes 68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667

Table of contents


Magento does not provide the ability to set special characters on controller or action names. This module fixes that by providing the ability to use -, ., ~, _ within a URL.


composer require markshust/magento2-module-specialrouter
bin/magento module:enable MarkShust_SpecialRouter
bin/magento setup:upgrade


This module is really simple to use. All you need to do is use the appropriate "name" that matches the symbol you'd like to use in the URL.

  • Symbol: -, Name: Dash
  • Symbol: ., Name: Period
  • Symbol: ~, Name: Tilda
  • Symbol: _, Name: Underscore

For example, to respond to a request with a frontName of foo at the following location:


Use a PHP class named:


The - in the URL will be translated to dash in the actionPath and actionName, so if we create files using Dash in the controller and action name, they will respond to these requests.


This course is sponsored by, the simplest way to learn Magento.

Mark Shust

My name is Mark Shust and I'm the creator of this repo. I'm a 6X Adobe Commerce Certified Developer and have been involved with Magento since the early days (v0.8!). I create technical education courses full-time for my company,