This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Nginx Mobile Theme


This plugin allows you to switch theme according to the User Agent on the Nginx reverse proxy.

Nginx Mobile Theme’s requirements are as follows.

Some Features

  • You can flush mobile’s and pc’s each caches automatically via Nginx Cache Controller.
  • Allow you to switch theme according to the user-agent.
  • Allow you to customize multiple mobile device support via filter-hook.

Nginx Configuration

Add mobile device detection to the nginx.conf.

set $mobile '';
if ($http_user_agent ~* '(iPhone|iPod|incognito|webmate|Android|dream|CUPCAKE|froyo|BlackBerry|webOS|s8000|bada|IEMobile|Googlebot\-Mobile|AdsBot\-Google)') {
    set $mobile "@smartphone";

Set proxy_cache_key.

proxy_cache_key "$mobile$scheme://$host$request_uri";

Send custom request header to the backend.

proxy_set_header X-UA-Detect $mobile;

Nginx Mobile Theme will switch theme when โ€˜@smartphoneโ€™ is received in the $_SERVER['HTTP_X_UA_DETECT'].

How to use

  1. Please access to the theme-customizer in the WordPress admin area.
  2. Please select Mobile Theme in the drop-down.
  3. Click โ€œSave & Publishโ€ button to save.

Multiple mobile device support

  1. Add custom mobile detection to the nginx.conf.
  2. Add custom mobile detection to the WordPress via nginxmobile_mobile_detects filter-hook.

set $mobile โ€;
if ($http_user_agent ~* โ€˜(iPhone|iPod)โ€™) {
set $mobile โ€œ@smartphoneโ€;
if ($http_user_agent ~* โ€˜iPadโ€™) {
set $mobile โ€œ@tabletโ€;

In your custom plugin:
add_filter(โ€˜nginxmobile_mobile_detectsโ€™, function(){
return array(โ€˜@smartphoneโ€™, โ€˜@tabletโ€™);

  • As a result, allow you to select theme for @smartphone and @tablet individually in the theme-customizer.

Amimoto Support

The Amimoto is a full-tuned WordPress AMI on the AWS EC2.

  • Uncomment /etc/nginx/conf.d/default.conf in line 17

#include /etc/nginx/mobile-detect;

include /etc/nginx/mobile-detect;

  • Add line to /etc/nginx/nginx.conf like following.

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Accept-Encoding โ€œโ€;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Accept-Encoding โ€œโ€;
proxy_set_header X-UA-Detect $mobile; # add new line

  • Define constant in the wp-config.php

    define(โ€˜IS_AMIMOTOโ€™, true);


  • theme-customizer


  1. Upload nginx-mobile-theme to the /wp-content/plugins/ directory.
  2. Activate the plugin through the โ€˜Pluginsโ€™ menu in WordPress.


There are no reviews for this plugin.

Contributors & Developers

“Nginx Mobile Theme” is open source software. The following people have contributed to this plugin.


Translate “Nginx Mobile Theme” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Add query strings mobile=on and mobile=off






  • Add support child theme.
  • Add notice when Nginx Cache Controller is not activated.…1.1.0


  • first release.