Custom Permalinks icon
Actively maintained Tested with WP 7.1 #410 most installed plugin #1 in custom url

Custom Permalinks

A powerful WordPress plugin for full URL control. Set custom permalinks, auto-redirects, and use dynamic tags for ideal site structure and SEO.

Active installs100K+100K+ tier
Downloads · 30d30.1K▼ -69% vs prev. 30d
Rating4.1/5116 reviews
Health score84/100Excellent
All-time downloads2.7MSince Nov 2008
Support resolved3 / 475% in last 2 months
RequiresWP 5.9PHP 7.4+
Overall rank#410of 75,342 plugins
Our verdict

Safe pick

Yes — Custom Permalinks is a safe, well-maintained plugin to use in 2026. It runs on 100K+ sites, is rated 4.1/5 and was last updated 1 month ago, and scores 84/100 on our health check.

  • Proven at scale on 100K+ active sites
  • Tested with the latest WordPress (7.1)

How does it stack up?

Side-by-side on installs, updates, ratings & support

Daily downloads

4.2K8.4K12.5KAug 19Oct 2Nov 16
Yesterday687
Daily average (1y)680
Peak day16,713Aug 21, 2026
Last 12 months247.7K

Download spikes usually follow a new release — each site that auto-updates counts as a download.

Rankings

Where Custom Permalinks stands today
Overall popularity #410 of 75,342 WordPress.org plugins Top 0.54%
100K+ installs tier 282 of 333
Next tier: 500K+ installs
Custom url #1 of 12 plugins → Permalink #3 of 143 plugins → Redirect #6 of 433 plugins → Seo #16 of 2,934 plugins → Slug #1 of 101 plugins →

WordPress.org search rankings

Live position in the plugin search, top 100
KeywordPositionCompeting pluginsCategory
custom url #2 10,000 Best custom url plugins →
permalink #2 4,104 Best permalink plugins →
redirect #57 8,101 Best redirect plugins →
seo >100 9,313 Best seo plugins →
slug #13 8,168 Best slug plugins →

Version adoption

Share of active sites per release.

  • 3.331.8%
  • 3.121.9%
  • 2.812.6%
  • 2.77.3%
  • 2.56.1%
  • 3.25.5%
  • Other14.8%

Rating breakdown

★★★★★★★★★★ 4.1 from 116 reviews

  • 5★69.0%
  • 4★8.6%
  • 3★2.6%
  • 2★1.7%
  • 1★18.1%

About Custom Permalinks

From the official readme · v3.3.3

Description

You want to take control of your WordPress site’s URLs? The Custom Permalinks plugin gives you the power to set unique, custom URLs for any post, page, tag, or category. This means you can design your site’s structure exactly how you envision it, rather than being limited by WordPress’s default settings. When you set a custom permalink, the original post URL will be automatically redirected to your new, customized URL.

Key Features

  • A custom URL for any content: Set a unique permalink for any post, page, public custom post type (e.g. WooCommerce products), category, tag, or custom taxonomy term.
  • Permalink structures per post type: Define a structure for each public post type from tags like %year%, %category%, or your custom taxonomies. New content gets its permalink automatically, and you can still edit any permalink by hand.
  • Automatic redirects: The original URL redirects to the custom permalink, so existing links, bookmarks, and search rankings keep working.
  • Multilingual: Works with WPML and Polylang, with a separate custom permalink for each translation.
  • URLs in any language: Permalinks in non-Latin scripts, such as Arabic, Thai, or Cyrillic, work as you type them.
  • All permalinks in one place: The Post Types Permalinks and Taxonomies Permalinks screens list every custom permalink, with search and bulk delete.
  • A role for permalink managers: The Custom Permalinks Manager role lets non-administrators view and edit permalinks.
  • Developer friendly: Filters and actions to add your own tags, generate permalinks in code, and control sanitizing and redirects.

Getting Started: Plugin Settings

Custom Permalinks adds a Custom Permalinks menu to your WordPress dashboard:

  • Post Types Permalinks and Taxonomies Permalinks: Every custom permalink on your site, with search and bulk delete.
  • Post Types Settings: A permalink structure for each public post type, built from the tags below. Leave a structure empty to keep WordPress’s default for that post type.

To set a permalink for an individual post, page, category, or tag, edit that item and look for the Custom Permalink field near the top (or in the sidebar) of the editor screen — enter the URL path you want and save.

Available Tags for Permalink Structures

When setting up your custom permalink structures, you can use a variety of tags that will dynamically populate the URL. Here’s a breakdown of what’s available:

  • %year%: The year of the post in four digits, eg: 2025
  • %monthnum%: Month the post was published, in two digits, eg: 01
  • %day%: Day the post was published in two digits, eg: 02
  • %hour%: Hour of the day, the post was published, eg: 15
  • %minute%: Minute of the hour, the post was published, eg: 43
  • %second%: Second of the minute, the post was published, eg: 33
  • %post_id%: The unique ID of the post, eg: 123
  • %category%: A clean version of the category name (its slug). Nested sub-categories will appear as nested directories in the URL.
  • %author%: The post author’s username (login name). Note that this makes usernames visible in your URLs.
  • %postname%: A clean version of the post or page title (its slug). For example, “This Is A Great Post!” becomes this-is-a-great-post in the URL.
  • %parent_postname%: Similar to %postname%, but uses the immediate parent page’s slug if a parent is selected.
  • %parents_postnames%: Similar to %postname%, but includes all parent page slugs if parents are selected.
  • %title%: The title of the post, converted to a slug. For example, “This Is A Great Post!” becomes this-is-a-great-post. Unlike %postname% which is set once, %title% automatically updates in the permalink if the post title changes (unless the post is published or the permalink is manually edited).
  • %ctax_TAXONOMY_NAME%: A clean version of a custom taxonomy’s name. Replace TAXONOMY_NAME with the actual taxonomy name.
  • %ctax_TAXONOMY_NAME_name%: The custom taxonomy term’s name (instead of its slug). Replace TAXONOMY_NAME with the actual taxonomy name.
  • %ctax_parent_TAXONOMY_NAME%: Similar to %ctax_TAXONOMY_NAME%, but includes the immediate parent category/tag slug in the URL if a parent is selected.
  • %ctax_parent_TAXONOMY_NAME_name%: Similar to %ctax_TAXONOMY_NAME_name%, but includes the immediate parent term’s name if a parent is selected.
  • %ctax_parents_TAXONOMY_NAME%: Similar to %ctax_TAXONOMY_NAME%, but includes all parent category/tag slugs in the URL if parents are selected.
  • %ctax_parents_TAXONOMY_NAME_name%: Similar to %ctax_TAXONOMY_NAME_name%, but includes all parent term names if parents are selected.
  • %custom_permalinks_TAG_NAME%: Developers have the flexibility to define their own custom tags (replace _TAG_NAME with your desired name). To ensure these tags resolve to the correct permalinks, simply apply the custom_permalinks_post_permalink_tag filter.

Important Note: For new posts, Custom Permalinks will keep updating the permalink while the post is in draft mode, assuming a structure is defined in the plugin settings. Once the post is published or its permalink is manually updated, the plugin will stop automatic updates for that specific post.

Custom Permalinks: Fine-Tuning with Filters

Custom Permalinks offers a range of filters that empower developers to precisely control its behavior. You can explore all available filters, complete with example code snippets, in our GitHub repository.

For Assistance:

  • Premium Users: If you need assistance implementing these filters, please don’t hesitate to reach out to us via our Premium contact support.
  • Other Users: You can also directly reach out to the plugin author via LinkedIn.

Need Help or Found a Bug?

  • Support: For one-on-one email support, consider purchasing Custom Permalinks Premium. While some basic support may be provided on the WordPress.org forums, email support is prioritized for premium users.
  • Bug Reports: If you encounter a bug, please report it on GitHub. Make sure to provide complete information to reproduce the issue. GitHub is for bug reports, not general support questions.

If you experience any site-breaking issues after upgrading, please report them on the WordPress Forum or GitHub with detailed information. You can always revert to an older version by downloading it from https://wordpress.org/plugins/custom-permalinks/advanced/.

Installation

You have two ways to install Custom Permalinks:

From within WordPress

  1. Go to Plugins > Add New in your WordPress dashboard.
  2. Search for “Custom Permalinks”.
  3. Click “Install Now” and then “Activate” the plugin from your Plugins page.

Manually via FTP

  1. Download the custom-permalinks folder.
  2. Upload the custom-permalinks folder to your /wp-content/plugins/ directory.
  3. Activate Custom Permalinks through the “Plugins” menu in your WordPress dashboard.

Changelog

Recommended update: fixes custom permalinks in non-Latin scripts (e.g. Persian) returning a 404 since 3.3.0 when a shorter custom permalink matched the start of the URL, and with an endpoint such as /feed/ appended.

3.3.3 – Oct 13, 2026

  • Bug:
    • Fixed an infinite redirect loop on percent-encoded custom permalinks without a trailing slash (e.g. Japanese), a regression in 3.3.0.

3.3.2 – Oct 11, 2026

  • Bug:
    • Fixed custom permalinks in non-Latin scripts returning a 404 (e.g. Persian) when a shorter custom permalink matched the start of the URL (e.g. a product/ page for product/سلام/), a regression in 3.3.0.
    • Fixed custom permalinks in non-Latin scripts not loading with an endpoint appended (e.g. /سلام/feed/).

3.3.1 – Oct 8, 2026

  • Bug:
    • Fixed the editor’s View Post and preview links not updating, or the wrong links being updated, after saving a custom permalink when the post’s previous URL contained characters such as ?, + or ( (e.g. ?p=123 for drafts).
    • Hardened the editor script to only update links with an http(s) URL on the site’s own domain.
  • Accessibility:
    • Added labels for screen readers to the checkboxes in Post Types Permalinks and Taxonomies Permalinks, the structure fields in Post Types Settings, and the Custom Permalink field on category, tag, and term screens.
    • Raised the text contrast of the structure tags in Post Types Settings and of the plugin descriptions on the About screen, and underlined links in its text.

3.3.0 – Oct 8, 2026

  • Changes to be aware of:
    • Requires WordPress 5.9 and PHP 7.4 or later, the oldest versions the plugin is now tested on. Sites on older versions keep 3.2.1.
    • Translations now come from translate.wordpress.org instead of files bundled with the plugin. It covers every bundled language and adds Serbian. Sites that installed the plugin outside wordpress.org, or turned off automatic translation updates, show English until the language pack is installed from Dashboard → Updates.
    • WPML translations now always resolve to their own custom permalink. Previously they returned another language’s custom permalink depending on the active (admin) language, which listed wrong URLs in Post Types Permalinks and in SEO plugins’ indexables and XML sitemaps (e.g. Yoast SEO).
    • %ctax_parents_TAXONOMY_NAME_name% now uses the parent terms’ names, as documented, instead of their slugs. Permalinks generated from now on change where a parent term’s name differs from its slug; saved permalinks are not changed.
  • Redirects and URLs:
    • Fixed custom permalinks in non-Latin scripts (e.g. Thai, Arabic, Cyrillic) returning a 404 or redirecting in an infinite loop, as the browser requests them percent-encoded while they are saved unencoded (or vice versa, depending on the site language).
    • Fixed the trailing-slash redirect and the redirect to the custom permalink dropping the page number (e.g. /news/page/2 redirected to /news/ instead of /news/page/2/).
    • Added the custom_permalinks_disable_remove_page_number filter to keep the /page/{number} segment in the requested URL, for custom archive pages whose pagination doesn’t advance.
    • Fixed the query string being corrupted (e.g. foo=bar became http://foo=bar) after a custom permalink was resolved.
    • Fixed comment links on paginated comments (e.g. /my-post/comment-page-2/) not following the custom permalink’s trailing slash, so a custom permalink without a trailing slash no longer gets comment URLs with one, and vice versa.
  • WPML and Polylang:
    • Fixed the WPML language switcher linking back to the current language instead of the translation when languages are in directories (e.g. /en/, /de/) and the translation uses the same custom permalink.
    • Fixed WPML language directories that differ from the language code (e.g. /de-de/ for de, as in WPML 5.0) not being repaired when duplicated, and the default language getting its directory added to a permalink when “hide the default language directory” is on.
    • Fixed English custom permalinks not being lowercased and cleaned of special characters with WPML 5.0’s region-based language codes (e.g. en-us).
    • Fixed Polylang translations sharing the same custom permalink (e.g. /en/technology and /zh/technology) redirecting to the other language when the translation’s stored language was missing or out of date.
  • Admin screens:
    • Fixed Post Types and Taxonomies Permalinks pagination showing the first page’s results on every page, ignoring sorting and search, when a persistent object cache (e.g. Redis or Memcached) is enabled. The lists now also refresh right after a permalink is added, changed or deleted.
    • Fixed bulk delete and search in Post Types and Taxonomies Permalinks failing with a “headers already sent” warning instead of redirecting.
    • Fixed short titles and permalinks being padded with leading spaces in the Post Types and Taxonomies Permalinks lists.
    • Fixed every post of a type showing and saving the same custom permalink when a theme or plugin runs a custom loop in the admin without resetting the global post.
    • Fixed the original permalink showing as the custom permalink in the edit screen’s permalink box and in the block editor, and being compared against when saving a post or term.
    • Fixed a fatal error on WordPress 5.9 and 6.0 when saving the Post Types Permalinks settings with the cache flush option, as wp_cache_flush_group() needs WordPress 6.1. Object caches that can’t flush a single group now get a full cache flush.
    • Fixed the “Custom Permalinks Manager” role name not being translatable.
    • Fixed Post Types Settings showing the WordPress address instead of the site address before each structure, which is wrong when WordPress is installed in a subdirectory.
  • Compatibility:
    • Fixed WooCommerce notices about accessing order data directly on order screens, as the permalink form read post fields from the WC_Order object.
    • Fixed posts updated by WP All Import being handled as new posts, which turned permalink regeneration back on and could replace their custom permalink with the post type’s structure.
    • Fixed the seems_utf8() deprecation notice on WordPress 6.9 and later.

Earlier versions

  • For the changelog of earlier versions, please refer to the separate changelog.txt file.

Full changelog on WordPress.org →

Screenshots

Set a custom permalink for any post or page from the Custom Permalinks box in the editor.
Set a custom permalink for any post or page from the Custom Permalinks box in the editor.
Post Types Permalinks lists every post, page, and custom post type with a custom permalink, with search and bulk delete.
Post Types Permalinks lists every post, page, and custom post type with a custom…
Taxonomies Permalinks lists every category, tag, and custom taxonomy term with a custom permalink.
Taxonomies Permalinks lists every category, tag, and custom taxonomy term with a custom…
Post Types Settings: build a permalink structure for each post type from the available tags.
Post Types Settings: build a permalink structure for each post type from the available…
Set a custom permalink for a category, tag, or custom taxonomy term on its edit screen.
Set a custom permalink for a category, tag, or custom taxonomy term on its edit screen.

For developers

Is this your plugin? Show off the numbers.

Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.

Active installs badge Rating badge Health score badge

Best Custom Permalinks alternatives

All custom url plugins →
Alternatives
Rank Plugin Active installs Rating Updated Health
2 WP Custom Author URL WP Custom Author URL Set a custom URL for your author name link, on a global or author-specific basis. Also… by Poodle Plugins 5K+ ★★★★★★★★★★ 5 (8) 7 months ago 56
3 Custom Permalink Editor Custom Permalink Editor Set Custom Permalink Editor on a per-post, per-tag per-page, and per-category basis. by Kings Crest Global 4K+ ★★★★★★★★★★ 5 (2) 10 months ago 51
4 YOURLS Link Creator YOURLS Link Creator Creates a custom short URL when saving posts. Requires your own YOURLS install. by Andrew Norcross 500+ ★★★★★★★★★★ 4.5 (13) 11 years ago 26
5 Custom URL for Elementor Custom URL for Elementor Enhance your Elementor designs by adding custom URLs and CSS to Container, Section, Column… by woologger 50+ ★★★★★★★★★★ No reviews 2 years ago 25
6 Ping.fm Custom URL Ping.fm Custom URL Receives blogs, micro-blogs, and status updates from Ping.fm and posts them to your blog in… by Matt Jacob 10+ ★★★★★★★★★★ No reviews 16 years ago 23
7 Wonkasoft Logout Wonkasoft Logout Wonkasoft Logout is a simple plugin for the adding of a redirect. by mrlister1 10+ ★★★★★★★★★★ No reviews 7 years ago 23
8 Vctlo 404 Redirector Vctlo 404 Redirector Redirect 404 pages to a custom URL with secure sanitization for better user experience and… by vctlocom 10+ ★★★★★★★★★★ No reviews 2 years ago 32
9 Easy url rewrite Easy url rewrite Create your custom URLs pointing to custom files. by bolmaster2 10+ ★★★★★★★★★★ No reviews 15 years ago 23
10 Floating Image PRO Floating Image PRO Floating Image adds custom image using URL links allows you to add a floating image. by WeDevlops <10 ★★★★★★★★★★ 5 (1) 2 years ago 31
11 Linkoryx – Custom Links & Redirects Linkoryx – Custom Links & Redirects Set custom URLs for WordPress posts, pages, and public custom post types. Replace links and… by Burhan Nasir <10 ★★★★★★★★★★ No reviews 3 weeks ago 52

FAQ

Custom Permalinks: quick answers

Straight answers, pulled from live WordPress.org data.

Live data from WordPress.org · checked Nov 17, 2026

Is Custom Permalinks free?

Yes. Custom Permalinks is free to download and use from the official WordPress.org plugin directory.

Is Custom Permalinks safe to use in 2026?

Yes — Custom Permalinks is a safe, well-maintained plugin to use in 2026. It runs on 100K+ sites, is rated 4.1/5 and was last updated 1 month ago, and scores 84/100 on our health check.

How many websites use Custom Permalinks?

Custom Permalinks is active on 100K+ WordPress websites and has been downloaded 2,733,408 times since it launched in November 2008. It was downloaded 30,077 times in the last 30 days.

Does Custom Permalinks work with WordPress 7.1?

Yes. The developer has tested Custom Permalinks up to WordPress 7.1.4, the latest release. It requires WordPress 5.9 or newer.

What PHP version does Custom Permalinks need?

Custom Permalinks requires PHP 7.4 or higher. Most hosts run PHP 8.x today, so it works on any modern WordPress hosting.

When was Custom Permalinks last updated?

The latest version, 3.3.3, was released on October 13, 2026 (1 month ago).

Who makes Custom Permalinks?

Custom Permalinks is developed and maintained by Sami Ahmed Siddiqui.

What are the best alternatives to Custom Permalinks?

The most popular alternatives to Custom Permalinks are WP Custom Author URL (5K+ installs), Custom Permalink Editor (4K+ installs) and YOURLS Link Creator (500+ installs).

Powered by PageForge

Want thousands of pages that rank like these? Build them in an afternoon.

This directory runs on the same engine as PageForge. Turn any spreadsheet, CSV or API into thousands of fast, SEO-ready WordPress pages — with schema, internal links and AI-written copy baked in.

  • CSV, Google Sheets & API data sources
  • AI content, schema & internal links per page
  • Works with Elementor, Gutenberg, Yoast & Rank Math
  • Free on WordPress.org — no credit card
Sarah is here to help!
Hi there! 👋 Need help finding what you're looking for?
Sarah
Sarah
Online & Ready to Help
Hi there! 👋 Need help finding what you're looking for?

We'll use this to continue our conversation

Just now ✓ Verified

Join 500+ SEO Pros Scaling Their Strategy

Get exclusive programmatic SEO tactics, AI content workflows, and the latest PageForge updates delivered straight to your inbox. Stay ahead of the algorithm.

We care about your data in our privacy policy.