SO Pinyin Slugs

plugin banner

Transforms Chinese character titles into a permalink friendly slug, showing pinyin that can be read by humans and (Chinese) search engines alike.

Author:SO WP (profile at
WordPress version required:4.4
WordPress version tested:5.5.1
Plugin version:2.2.0
Added to WordPress repository:19-08-2013
Last updated:31-03-2020
Rating, %:100
Rated by:4
Plugin URI:
Total downloads:25 087
Active installs:4 000+
plugin download
Click to start download

The Pinyin Slugs plugin is a fork of the original Pinyin Permalinks plugin by user xiaole_tao who has seemingly abandoned his plugin as he never responded to emails.

The original plugin can basically only be used on Chinese only websites; as soon as you install it on a bi/multilingual site it messes up the slugs of the non-Chinese languages.

This fork has been adapted by my ex-colleague Denis Cao in such a way that the slugs of the non-Chinese language remain untouched and only the Chinese character slugs will be transformed into pinyin.

Chinese characters don’t come out good in permalinks. Without the Pinyin Slugs plugin activated, the example post I made for the screenshot will get a slug like this: %e6%90%9c%e7%b4%a2%e5%bc%95%e6%93%8e%e4%bc%98%e5%8c%96. With the plugin the slug automatically becomes sousuoyinqingyouhua.

Search engines such as Baidu obviously cannot make much of the first slug, but they can handle pinyin perfectly, especially when it is written as one long string without hyphens or underscores.

So instead of transforming “中国” into two separate words divided by a hyphen or an underscore (the original plugin has this as options), it is best transformed into “zhongguo”. The only option Pinyin Slugs therefore has left is the length that you can limit to an x amount of letters. The default is 100, which should be plenty for most.

I have decided to only support this plugin through Github. Therefore, if you have any questions, need help and/or want to make a feature request, please open an issue over at Github. You can also browse through open and closed issues to find what you are looking for and perhaps even help others.


Thanks for your understanding and cooperation.

Gutenberg Compatible

Pinyin Slugs also works with the new WP editor (Gutenberg) although the slugs are only changed upon saving the post/page, not immediately. This has to do with the way this new editor works.

ClassicPress Compatible

Because ClassicPress is forked on WP 4.9.8 the Pinyin Slugs plugin is automatically also compatible with ClassicPress.

WPML Compatible

The Pinyin Slugs plugin has received the WPML Certification of Compatibility.