Custom Permalinks

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/ .