If you create a custom post type in WordPress, its slug will be added to the permalink (URL) structure by default. This can be desirable for grouping types of posts together, but it can also result in longer, harder-to-remember URLs, not to mention articles that don’t rank as highly on Google according to Yoast, who is an authority on WordPress search engine optimization (SEO). In this post, I’ll cover how to safety and properly remove the custom post type slug from your permalinks.
Recently, I began creating a number of sites for a racing company that puts on 5K, 10K, marathon, and other distance races and fun runs. For these sites, I created a custom post type called “race”. This resulted in permalinks such as example.com/race/race-title. As you can see, this is not nearly as clean, easy to remember, or search engine optimized as having permalinks like example.com/race-title would be. I found a great post on WordPress.com VIP entitled “How to Remove Custom Post Type Slug from Permalinks,” but it appears that the post has been deleted, so I’ll outline the process below.
1. Create your custom post type (unless already created). This can be done very easily by using the great, free Custom Post Type UI plugin.
2. Create a plugin for our new code to live in (yes, it could go in the functions.php file, but then it’d be lost if the theme were changed!).
3. Filter the permalink for our custom post type such that all published posts don’t have the slug in the URI:
4. At this point, trying to view the link would result in a 404. That’s because WordPress only knows the URI can be Posts or Pages. We need to teach it to also pay attention to our custom post type by adding the following:
5. That’s it! Just change both instances of “race” to the slug of your custom post type, and replace “gp_” with whatever function prefix you’d like (your initials would be fine), and you should be all set. Going to Settings > Permalinks and saving the permalink structure to end in /%postname%/ may also be necessary.