No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Latest commit a512a21 Dec 27, 2017
Failed to load latest commit information.
lib Move regex defining Apr 27, 2015
.gitignore - Fixed an error Apr 9, 2012 Update Dec 26, 2017
index.js First commit Jan 29, 2012
package.json Add repository field Apr 26, 2015


express-subdomain-handler takes the headache out of dynamic subdomain routing in Express. It captures the contents of any subdomain and writes them into the Express req.url. This means you can write specific route handlers for subdomain urls.

As you can see below, express-subdomain-handler can manage single or multiple subdomains.


  • => '/subdomain/mysubdomain/'
  • => '/subdomain/myexcellentsubdom/homepage'
  • => '/subdomain/first/second/'
  • => '/subdomain/first/second/another/page'


npm install express-subdomain-handler


Add express-subdomain-handler to your express middleware stack (before your routes are specified). You need to specify what the base url of your site is ('', 'example.local', etc), what you what subdomain urls to be prefixed with ('subdomain' by default) and whether you want logging turned on (false by default)

app.use( require('express-subdomain-handler')({ baseUrl: '', prefix: 'myprefix', logger: true }) );

Setup routes to catch subdomain urls so for I would write my route handler to look like this.

app.get('/myprefix/:thesubdomain/thepage', function(req, res, next){

  // for the example url this will print 'mysubdomain'


Follow me

If you like my stuff, follow me on Twitter