WordPress Pretty Permalinks with Nginx

Setting Permalinks in WordPress is simple and flexible. Core WordPress checks to see if the Apache mod_rewrite module is loaded before fully enabling permalinks. If that check fails then it includes index.php in your permalink structure in order to make sure that WordPress still gets a chance to process URLs.

Servers using Nginx are able to do URL rewriting, but the check still fails, leaving index.php in the permalink. Fortunately a few lines of PHP in a plugin (I like to put it in wp-content/mu-plugins/nginx.php) can fix that:

[sourcecode lang=”php”]
add_filter( ‘got_rewrite’, ‘nginx_has_rewrite’, 999 );
function nginx_has_rewrite( $got_rewrite ) {
return TRUE;

Those few lines of PHP will tell WordPress that full URL rewriting is available on the server, so no more index.php in the permalink structure.

Before adding this make sure that you’ve already setup URL rewriting in your Nginx configuration.

Update: In the comments Sivel mentioned another alternative:

[sourcecode lang=”php”]
add_filter( ‘got_rewrite’, ‘__return_true’, 999 );

The __return_true function was added during WP 3.0 development for exactly these sorts of things, where you want to just return TRUE for a filter. I like it.

22 replies on “WordPress Pretty Permalinks with Nginx”

You are correct, this something that was introduced as part of the 3.0 development cycle when bringing in WPMu. If you never touch your permalink structure after the upgrade to 3.0 you should be fine, but without adding this code it could introduce index.php into your permlaink structure.

Me too never had problem with this.
I am running 2 big MU’s with domain mapping and most blogs have their own permalink structure.
But with reference to other comments, if this is an issue with 3.0, thanks a lot Joseph in advance

Awesome, thanks a ton for this. I know this is an old post and all, but is there any way to implement this directly into the vhost config with nginx? That way you dont have to add this file as a plugin etc?

Changing the Nginx config won’t impact this. Best you could hope for was to get an update in WordPress that would make this an option. Outside of that you’ll need to stick with the simple plugin.

Currently I am using Nginx Compatibility plugin for this purpose..But want to replace that with this code..Can I place above code in functions.php file of my theme..?

Leave a Reply

Your email address will not be published. Required fields are marked *