How to Change Custom Post Type (CPT) Permalinks in WordPress

In WordPress, you can use custom post types to extend the standard posts and pages. They use their own permalink structures, which usually consist of the post type slug followed by the specific title.

If you want to adjust these permalink structures, the standard WordPress permalink settings may not be sufficient. The built-in permalink options apply to standard posts and offer only limited control over custom post types.

Permalink Manager removes this limitation and allows you to customize the permalinks for any custom post type directly from the WordPress dashboard.

Whenever a URL is changed, the plugin automatically redirects the old address to the new one. This helps prevent 404 errors and keeps your internal and external links working properly.

Understanding Custom Post Type URLs

Most WordPress sites work with two main content types: pages and posts. When your content does not fit into them, you can create custom content types to keep it separate. Custom types can have their own fields, layouts, and rules, so you can treat them differently from standard posts.

Many plugins depend on custom post types to organize their data. WooCommerce, for example, uses custom types to manage products, while others handle events, courses, portfolios, testimonials, or job listings.

Each custom post type has a defined permalink structure. This structure usually includes two parts: the rewrite slug and the item slug.

1. The rewrite slug is the base part of the URL (e.g. /book/ ). It groups all posts of the same post type and must be unique. WordPress uses this slug in the permalink structure to separate content types and prevent URL conflicts and 404 errors.
2. The item slug is the last part of the URL (e.g. /2001-a-space-odyssey/ ) and points to one specific post. It is created from the post title and can be edited in the post editor.

WordPress uses rewrite slugs to figure out which content to load by matching them to its built-in rewrite rules. After identifying the post type, it retrieves the right item based on the item slug.

How to Change Permalink Structure for Custom Post Type Without a Plugin?

In general, you can change the individual slug for any single custom post directly in the admin dashboard. If you want to modify the permalink structure for all posts in a custom post type, you must use a code snippet or install a dedicated permalink plugin, such as Permalink Manager.

How to Change Rewrite Slug (Base)?

The permalink structure is not managed through the standard WordPress permalink functions. By default, WordPress sets the rewrite slug to the same value as your custom post type name.

If you need a different permalink structure, you can adjust the it during post type registration. The process differs depending on whether the post type was registered in code or via a plugin like ACF, Toolset, or Pods.

Using register_post_type() function

When registering a custom post type, you can set a different permalink slug than the post type name. To do so, set a different " slug " in the " rewrite " parameter when calling register_post_type() function.

In the example below, the original post type name "book" is changed to "publication".

function custom_post_type_registration() {
	 $args = array(
		 'public' => true,
		 'label' => 'Book',
		 'supports' => array('title', 'editor', 'thumbnail'),
		 'rewrite' => array('slug' => 'publication'),
	 );
	 register_post_type('book', $args);
}
add_action('init', 'custom_post_type_registration');

ACF and Other CPT Plugins

If you created a custom post type with a plugin such as ACF or Pods, you can change the permalink base in the same place where you manage the post type settings. To do this:

1. Navigate to "ACF -> Post Types" and select the relevant post type.
2. Turn on "Advanced Configuration".
3. Under the "URLs" tab, set "Permalink Rewrite" to "Custom Permalink" and enter your new slug in the "URL Slug" field.

How to Change Slugs For CPT Items

You can change the slug for each individual post directly from the WordPress admin dashboard. In the example below, the input field (with "anna-nowak") lets you quickly edit the slug for that specific item.

The rewrite base ("team") cannot be edited here, as it applies to all posts within this custom post type. Since it is managed as a global setting, WordPress does not allow to edit it inside the post editor. For that reason, it is shown as static text.

Common Custom Post Type Permalink Issues

A frequent question is why it is so hard to remove a CPT slug from the permalink structure, for example changing /product/iphone/ to just /iphone/ . The reason is how the permalink rewrite mechanism in WordPress core works.

Why You Can't Just Remove the CPT Base?

Each custom post type and taxonomy has its own rewrite rules stored in the rewrite table. WordPress checks this table on every page load and stops at the first rule that matches the URL.

If two post types use a similar permalink structure, or if you remove the rewrite slug (CPT base) to use a root-level URLs like pages, URL conflicts are inevitable.

In most cases, this results in 404 errors for either your custom post type items or regular pages.

The Forced Unique Slug Problem

When you publish a post, the slug is created from the post title. WordPress then checks the database using the wp_unique_post_slug() function to make sure the slug is unique.

If the same slug already exists in the database, even for a different post type, WordPress adds a number like "-2" or "-3". This happens because without unique slugs, the rewrite system may not link the URL to the correct post.

Overriding Custom Post Type Permalinks with Permalink Manager

The built-in permalinks in WordPress are limited to basic structures. Using a plugin or a extra code snippet, you can remove default rewrite bases, add category names, or standardize URLs across post types.

For a detailed guide on how to set up and use custom permalinks to organize your site’s URLs, see our full article about custom permalinks.

Allowing Duplicate Slugs

By default, WordPress does not allow two posts to use the same slug. This rule applies even if the posts belong to different post types or taxonomies. When a duplicate slug is detected, WordPress automatically adds a number such as "-2" to the URL.

This can be problematic on multilingual websites, in hierarchical permalink structures, or in setups where identical titles exist under different parent URLs.

Permalink Manager removes this restriction and lets you use duplicate slugs where it actually makes sense.

Removing CPT Slug from Permalinks

WordPress automatically includes the post type name (slug) in your URLs. This makes the permalink structure longer and repetitive.

There is no built-in option in the WordPress settings to remove those bases. Removing it manually through custom code may break rewrite rules and lead to URL conflicts and 404 errors.

With Permalink Manager, you can remove the post type slugs (bases) safely directly in the admin panel, without writing a single line of code.

Adding Taxonomy to Custom Post Type URLs

Standard WordPress settings do not support adding taxonomy slugs to custom post type URLs. Permalink Manager fills that gap.

Once set up, it lets you include any taxonomy term in your URL structure and the plugin handles the rest automatically. This creates logical, hierarchical URLs that reflect content relationships.

For websites using Yoast SEO, Rank Math or SEOPress, the plugin also respects the primary category setting, so only the correct term is used in the permalink.

Including Custom Fields in WordPress Permalinks

Out of the box, WordPress does not allow custom field values to be included in permalink formats.

Permalink Manager makes this possible and it allows custom field values to be added to permalinks automatically.

As a result, you can create structured URLs based on SKU numbers, locations, or other custom metadata. The solution is compatible with ACF, Meta Box, JetEngine, Toolset, Pods, and other plugins and themes that store data using the standard post meta system.

Individual URL Adjustments

WordPress normally applies one permalink structure to all posts of the same type. That works fine until you need something different for just one post or page.

Permalink Manager adds a dedicated URL field to every post, page, and term in your dashboard. From there, you can change the permalink for any individual item at any time.

This gives you full control over individual permalinks when you need specific URLs for SEO, site migration, or to keep legacy links working.

FAQ