Home » Hooks » the_permalink

The the_permalink hook is a powerful WordPress hook that allows developers to modify the permalink of a post or page before it is displayed on the front-end. This hook is primarily used to dynamically alter the URL structure of individual posts or pages.

When a user visits a WordPress website, the URL structure is a crucial component for navigation and SEO purposes. By default, WordPress generates permalinks based on the post or page title, but sometimes you may need to customize these URLs to meet specific requirements.

The the_permalink hook comes into play in such scenarios, enabling developers to manipulate the permalink according to their needs. This can include adding prefixes or suffixes, inserting additional query parameters, or even completely changing the structure of the URL.

For instance, let’s say you have a website with a custom post type called "products" and you want to add the category name to the permalink. You can achieve this using the the_permalink hook with the help of a custom function.

function custom_permalink($permalink, $post, $leavename) {
    if ($post->post_type === 'products') {
        $category = get_the_category($post->ID);
        if (!empty($category)) {
            $permalink = str_replace('%category%', $category[0]->slug, $permalink);
    return $permalink;
add_filter('the_permalink', 'custom_permalink', 10, 3);

In the above example, we define a function called custom_permalink that takes three parameters: $permalink, $post, and $leavename. Within the function, we check if the post type is "products" and retrieve the category associated with the post using get_the_category.

If a category is found, we replace the %category% placeholder in the $permalink with the category’s slug. Finally, we return the modified permalink.

By adding this code to your theme’s functions.php file or a custom plugin, the permalinks for all "products" posts will now include the category name, giving you SEO-friendly URLs like

Remember, when using the the_permalink hook, make sure to test your code thoroughly to ensure that the modified permalinks function correctly and do not cause any conflicts with other plugins or themes.

Learn More on

WordPress snippets using the the_permalink hook

Register an account to save your snippets or go Pro to get more features.