ThemeKey allows you to define simple or sophisticated theme-switching rules which allow automatic selection of a theme depending on current path, taxonomy terms, language, node-type, and many, many other properties. It can also be easily extended to support additional properties exposed by other modules. In combination with Drupal's theme inheritance you can easily achieve features like:

  • individually-styled channels
  • a front-page / "splash" screen
  • a date/time-selected Christmas theme
  • mobile themes for different auto-detected mobile devices
  • special themes for "limited" or "old" browsers
  • content, user, or role -specific themes
  • indicating your environment (production, staging, testing, sandbox, … )
  • testing your redesign safely on a live server
  • ...

And unlike other theme switching modules, ThemeKey should play well with internal and external page caches, like Boost or Varnish, even for anonymous users.

Feedback is welcome!

Damn, ThemeKey ... ROCKS! Really appreciate the kick ass work you did on this :) mortendk

I must say, this module is underrated. ThemeKey Properties makes ThemeKey awesome. It's right up there with Rules, Context, and Panels. My mind is blown away at the flexibility. :-) momendo

ThemeKey 7.x for Drupal 7

ThemeKey 7.x contains some noteworthy differences compared to ThemeKey 6.x:

  • The optional module ThemeKey User Profile replaces the Drupal 6 themes per user core feature, which has been removed from Drupal 7 core.
  • The optional module ThemeKey Compatibility solves the generic problem of concurrent theme switching modules by integrating them into it's Theme Switching Rule Chain. Now you can combine features like core's Administration Theme, Organinc Groups Theme and many more using ThemeKey.
  • The additional module ThemeKey Properties became part of ThemeKey itself.

What's new in ThemeKey 7.x-3.x?

3.x offers more functionality for mobile devices. It integrates with Browscap and Mobile Detect and contains a new sub-module named ThemeKey Redirect to create an additional rule chain to redirect the user, for example to a simplified mobile version of a site.

The new sub-module ThemeKey CSS offers an additional rule chain to add single CSS files based on rules, instead of or in addition to switching the theme.

All Fields assigned to nodes became ThemeKey properties to create rules based on field values!

A lot of other improvements. Have a look at the CHANGELOG.txt for details.

For developers: More hooks and some reusable components to extend ThemeKey more easily.

ThemeKey 8.x for Drupal 8

ThemeKey 8.x requires a complete re-write due to the heavy changes in core. But the work on it has been started during the code sprints at Drupal Con Amsterdam. The key architectural design decisions are implemented already.

But to be honest, the port / re-write of all the ThemeKey features will take a lot of time. To speed it up we need more developers or some funding to spend more time on it. Feel free to contact us.

Special Module Integrations

Beside the standard features ThemeKey automatically extends it's features if one of these modules gets installed:

As mentioned above, in D7 every theme switching module that implements hook_custom_theme() could become part of ThemeKey's rule chain using the included ThemeKey Compatibility module.

Related Projects / Modules extending ThemeKey

  • ThemeKey Properties offers additional properties you can choose from to ThemeKey 6.x.
  • Taxonomy Theme offers a user interface to trigger selection of different themes based on taxonomy and uses ThemeKey as its back end.
  • ThemeKey CiviCRM provides CiviCRM related properties.
  • MobileKey - another approach to handle mobile devices beside ThemeKey's internal client detection and the WURFL-Integration.
  • Mobile Tools (7.x-3.x will use ThemeKey for the theme switching part)
  • Crumbs
  • Domain ThemeKey integrates Domain Access and ThemeKey
  • ...


After installing ThemeKey, you'll have access to a lot of documentation using Drupal's built-in help system at /admin/help/themekey. You will find descriptions of all ThemeKey properties, some examples, and tutorials. The ThemeKey 6.x tutorials are also available at
Just click the "Tutorials" link to open the collapsed overview.

ThemeKey 7.x contains an optional module called ThemeKey Example to demonstrate developers how to extend ThemeKey.


Sessions / Slides / Videos

Supporting organizations: 

Project information