Single Category Permalink

Author:Scott Reilly
First released:2011-07-18
Last update:2017-02-27
Compatibility:WP 4.6 – 4.7.12
Download:[ zip ]

Reduce permalinks (category or post) that include entire hierarchy of categories to just having the…

Extended Description

Reduce permalinks (category or post) that include entire hierarchy of categories to just having the lowest category in the hierarchy.

By default, WordPress replaces the %category% permalink tag in a custom permalink structure with the entire hierarchy of categories for the post’s first matching category. For example, assuming your site has a hierarchical category structure like so:

  |_ Desktop
  |_ Web
    |_ WordPress

By default, if you have a permalink structure defined as %category%/%year%/%monthnum%/%day%/%postname%, your post titled “Best Plugins” assigned to the “WordPress” category would have a permalink of:

If you activate the Single Category Permalink plugin, this would be the permalink generated for the post (and recognized by the blog):

In order for a category to be used as part of a post’s permalink structure, %category% must be explicitly defined in the Settings -> Permalinks admin page as part of a custom structure, i.e. /%category%/%postname%.

For category links, %category% is implied to follow the value set as the “Category base” (or the default category base if none is specified). So if your category base is ‘category’, the above example would list posts in the ‘WordPress’ category on this category listing page:

With this plugin activated, that link would become:

NOTE: The fully hierarchical category and post permalinks will continue to work. The plugin issues a 302 redirect to browsers and search engines pointing them to the shorter URL.

Links: Plugin Homepage | Plugin Directory Page | Author Homepage


The plugin exposes one filter for hooking. Typically, customizations utilizing this hook would be put into your active theme’s functions.php file, or used by another plugin.

c2c_single_category_redirect_status (filter)

The ‘c2c_single_category_redirect_status’ hook allows you to specify an HTTP status code used for the redirect. By default this is 302.


  • $status (integer) : The default HTTP status code


// Change single category redirect to 302
 * Change the redirection HTTP status to a 302.
 * @param  int $code The HTTP status code. By default 301.
 * @return int
function scp_change_redirect_status( $code ) {
    return 302;
add_filter( 'c2c_single_category_redirect_status', 'scp_change_redirect_status' );

Find out more at the plugin’s WordPress Plugin Repository page.


  1. Unzip inside the /wp-content/plugins/ directory for your site (or install via the built-in WordPress plugin installer)
  2. Activate the plugin through the ‘Plugins’ admin menu in WordPress
  3. Use %category% as a permalink tag in the Settings -> Permalinks admin options page when defining a custom permalink structure

Frequently Asked Questions

Q. Will existing links to my site that used the full category hierarchy still work?
A. Yes, WordPress will still serve the category listings and posts regardless of whether it is of the full category hierarchy format or just the single category format. But do note that WordPress doesn’t perform any sort of redirects; it responds directly to the category/post URL requested.

Q. Could this give the appearance that I have duplicate content on my site if pages are accessible via the full category hierarchy permalink format and the single category permalink format?
A. Whether this plugin is active or not, WordPress treats both types of category links the same. This plugin will however issue redirects for all of the non-canonical category and post permalink pages to point to the single category link version.

Q. What can this plugin do for me if I don’t use `%category%` in my custom permalink structure?
A. In addition to handling custom permalink structures (used to generate permalinks for posts) that contain %category%, the plugin also shortens category archive links. WordPress by default generates those links in a fully hierarchical fashion which this plugin will reduce to a single category. See the Description section for an example.

Q. Does this plugin include unit tests?
A. Yes.

Release Log

2.2 (2017-02-10)

  • Fix: Replace use of deprecated (in WP 4.7) _usort_terms_by_ID() with wp_list_sort() for WP 4.7+.
  • Change: Change default redirect HTTP status code from 302 (temporary redirect) to 301 (permanent redirect).
  • Change: Wrap functionality in class.
    • Create class c2c_SingleCategoryPermalink
    • Deprecate existing functions: c2c_single_category_catlink(), c2c_single_category_postlink(), c2c_single_category_redirect()
    • Move deprecated function functionality to class methods: category_link(), post_link(), template_redirect()
    • Add method version() to return plugin version
  • Add get_http_redirect_status() for getting the HTTP status code for redirects.
  • Change: Default WP_TESTS_DIR to /tmp/wordpress-tests-lib rather than erroring out if not defined via environment variable.
  • Change: Enable more error output for unit tests.
  • Change: Note compatibility through WP 4.7+.
  • Change: Remove support for WordPress older than 4.6 (should still work for earlier versions back to WP 1.5)
  • Change: Update copyright date (2017).

2.1.2 (2016-03-29)

  • New: Add LICENSE file.
  • New: Add empty index.php to prevent files from being listed if web server has enabled directory listings.
  • New: Add ‘Text Domain’ to plugin header.
  • Change: Minor code reformatting.
  • Change: Explicitly declare methods in unit tests as public; minor unit test doc reformatting.
  • Change: Note compatibility through WP 4.5+.
  • Change: Update copyright date (2016).

2.1.1 (2015-02-17)

  • Reformat plugin header
  • Note compatibility through WP 4.1+
  • Change documentation links to to be https
  • Update copyright date (2015)
  • Add plugin icon

2.1 (2014-01-24)

  • Add unit tests
  • Minor documentation improvements
  • Minor code reformatting (spacing, bracing)
  • Note compatibility through WP 3.8+
  • Update copyright date (2014)
  • Change donate link
  • Add banner


  • Add check to prevent execution of code if file is directly accessed
  • Note compatibility through WP 3.5+
  • Update copyright date (2013)
  • Minor code reformatting (spacing)


  • Re-license as GPLv2 or later (from X11)
  • Add ‘License’ and ‘License URI’ header tags to readme.txt and plugin file
  • Remove ending PHP close tag
  • Note compatibility through WP 3.4+


  • Note compatibility through WP 3.3+
  • Add link to plugin directory page to readme.txt
  • Update copyright date (2012)


  • Fix bug triggered when creating new post


  • Fix compatibility bug relating to generation of category permalink
  • Rename single_category_postlink() to c2c_single_category_postlink()
  • Rename single_category_catlink() to c2c_single_category_catlink()
  • Add c2c_single_category_redirect() to redirect hierarchical category links to the single category alternative
  • Add filter ‘c2c_single_category_redirect_status’ to allow override of default redirect status code
  • Wrap all functions in if (!function_exists()) check
  • Remove docs from top of plugin file (all that and more are in readme.txt)
  • Add plugin homepage and author links in description in readme.txt
  • Note compatibility through WP3.2+
  • Add PHPDoc documentation
  • Expand documentation in readme.txt
  • Minor tweaks to code formatting (spacing)
  • Minor documentation reformatting in readme.txt
  • Change description
  • Add package info to top of plugin file
  • Add Frequently Asked Questions, Filters, Changelog, and Upgrade Notice sections to readme.txt
  • Update copyright date (2011)


  • Initial release

Copyright & Disclaimer

Copyright © 2011-2019 by Scott Reilly (aka coffee2code)

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Discussion / Support

Have any questions, comments, or suggestions? Please provide them via the plugin’s support forum. I’ll do my best to reply in a timely fashion and help as best I can.

Unfortunately, I cannot provide guaranteed support, nor do I provide support via any other means.

Was this plugin useful useful to you? Consider giving it a rating. If you’re inclined to give it a poor rating, please first post to the support forum to give me a chance to address or explain the situation.