Ryan

Permalink Shortcode is a relatively simple plugin that implements a shortcode that you can use to link to existing posts and pages on your site. The shortcode also supports a number of HTML attributes (see below).
While WordPress does include a feature that allows you to link to existing content, this feature only inserts a “static” link. If you were to change the slug for that post or page, previously inserted links would no longer be valid.
The permalink shortcode can be used in two forms:
<ol>
<li>Standard: <code><a href="[permalink wpid='123']">link text</a></code></li>
<li>Enclosing: <code>[permalink wpid="123"]link text[/permalink]</code></li>
</ol>
(Note the single quotes used in the standard form example above. Using double quotes in this situation will not work.)
<h4>Supported Attributes</h4>
The following attributes are available in both the shortcode’s standard form and its enclosing form:
<ul>
<li><code>wpid</code>: The ID number of the post or page to which you want a link.</li>
<li><code>query</code>: The part of a URL that comes after the ‘?’ (e.g. “?foo=bar”). The ‘?’ is optional and will be added automatically if not included.</li>
<li><code>fragment</code>: The part of the URL that comes after the ‘#’ (e.g. “#comments”). The ‘#’ is optional and will be added automatically if not included.</li>
</ul>
The following HTML attributes are available only in the shortcode’s enclosing form:
<ul>
<li><code>accesskey</code></li>
<li><code>charset</code></li>
<li><code>class</code></li>
<li><code>dir</code></li>
<li><code>hreflang</code></li>
<li><code>id</code></li>
<li><code>lang</code></li>
<li><code>media</code></li>
<li><code>rel</code></li>
<li><code>rev</code></li>
<li><code>style</code></li>
<li><code>target</code></li>
<li><code>title</code></li>
<li><code>type</code></li>
</ul>
Things to be aware of with some of the above attributes:
<ul>
<li>In the enclosing form, the CSS class name <code>permalink-shortcode</code> is always added to the <code>class</code> attribute, even if you don’t specify any class names yourself.</li>
<li>In the enclosing form, if no value is given for the <code>title</code> attribute, the post or page title will be used.</li>
</ul>
<h4>Usage Examples</h4>
Simple link (standard form):
<blockquote>
<code><a href="[permalink wpid='123']">link text</a></code>
</blockquote>
Result:
<blockquote>
<code><a href="http://www.example.com/hello-world/">link text</a></code>
</blockquote>
Simple link (enclosing form):
<blockquote>
<code>[permalink wpid="123"]link text[/permalink]</code>
</blockquote>
Result:
<blockquote>
<code><a href="http://www.example.com/hello-world/" class="permalink-shortcode" title="Hello, world!">link text</a></code>
</blockquote>
Linking to the Comments section of a post (standard form):
<blockquote>
<code><a href="[permalink wpid='123']#comments">link text</a></code>
…or…
<code><a href="[permalink wpid='123' fragment='comments']">link text</a></code>
</blockquote>
Result:
<blockquote>
<code><a href="http://www.example.com/hello-world/#comments">link text</a></code>
</blockquote>
Adding a custom CSS class and title (enclosing form):
<blockquote>
<code>[permalink wpid="123" class="my-class" title="Some Other Page"]link text[/permalink]</code>
</blockquote>
Result:
<blockquote>
<code><a href="http://www.example.com/hello-world/" class="permalink-shortcode my-class" title="Some Other Page">link text</a></code>
</blockquote>

Permalink Shortcode

Provides a shortcode that allows you to insert permalinks into your content.

Sami Ahmed Siddiqui

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.
<h3>Key Features</h3>
<ul>
<li>Individual Permalink Control: Assign unique URLs to any post, page, tag, or category.</li>
<li>Site Structure Control: Gain ultimate control over how your site’s URLs are organized.</li>
<li>Post Type Permalink Structures (v3.0.0+): Define custom permalink structures for each public Post Type using predefined tags, automatically generating URLs upon content creation. You can still manually edit any permalink. If left empty, default settings will apply.</li>
</ul>
<h3>Getting Started: Plugin Settings</h3>
You can configure Custom Permalinks by navigating to Settings > Custom Permalinks in your WordPress Dashboard.
<h3>Available Tags for Permalink Structures</h3>
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:
<ul>
<li>%year%: The year of the post in four digits, eg: 2025</li>
<li>%monthnum%: Month the post was published, in two digits, eg: 01</li>
<li>%day%: Day the post was published in two digits, eg: 02</li>
<li>%hour%: Hour of the day, the post was published, eg: 15</li>
<li>%minute%: Minute of the hour, the post was published, eg: 43</li>
<li>%second%: Second of the minute, the post was published, eg: 33</li>
<li>%post_id%: The unique ID of the post, eg: 123</li>
<li>%category%: A clean version of the category name (its slug). Nested sub-categories will appear as nested directories in the URL..</li>
<li>%author%: A sanitized version of the post author’s name.</li>
<li>%postname%: A clean version of the post or page title (its slug). For example, “This Is A Great Post!” becomes <code>this-is-a-great-post</code> in the URL.</li>
<li>%parent_postname%: Similar to <code>%postname%</code>, but uses the immediate parent page’s slug if a parent is selected.</li>
<li>%parents_postnames%: Similar to <code>%postname%</code>, but includes all parent page slugs if parents are selected.</li>
<li>%title%: The title of the post, converted to a slug. For example, “This Is A Great Post!” becomes <code>this-is-a-great-post</code>. Unlike <code>%postname%</code> which is set once, <code>%title%</code> automatically updates in the permalink if the post title changes (unless the post is published or the permalink is manually edited).</li>
<li>%ctax_TAXONOMY_NAME%: A clean version of a custom taxonomy’s name. Replace <code>TAXONOMY_NAME</code> with the actual taxonomy name. You can also provide a default slug for when no category/taxonomy is selected by using <code>??</code> (e.g., <code>%ctax_type??sales%</code> will use “sales” as a default).</li>
<li>%ctax_parent_TAXONOMY_NAME%: Similar to <code>%ctax_TAXONOMY_NAME%</code>, but includes the immediate parent category/tag slug in the URL if a parent is selected.</li>
<li>%ctax_parents_TAXONOMY_NAME%: Similar to <code>%ctax_TAXONOMY_NAME%</code>, but includes all parent category/tag slugs in the URL if parents are selected.</li>
<li>%custom_permalinks_TAG_NAME%: Developers have the flexibility to define their own custom tags(replace <code>_TAG_NAME</code> with your desired name). To ensure these tags resolve to the correct permalinks, simply apply the <code>custom_permalinks_post_permalink_tag</code> filter.</li>
</ul>
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.
<h3>Custom Permalinks: Fine-Tuning with Filters</h3>
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 <a href="https://github.com/samiahmedsiddiqui/custom-permalinks" rel="nofollow ugc">GitHub repository</a>.
For Assistance:
<ul>
<li>Premium Users: If you need assistance implementing these filters, please don’t hesitate to reach out to us via our <a href="https://www.custompermalinks.com/contact-us/" rel="nofollow ugc">Premium contact support</a>.</li>
<li>Other Users: You can also directly reach out to the plugin author via <a href="https://www.linkedin.com/in/sami-ahmed-siddiqui/" rel="nofollow ugc">LinkedIn</a>.</li>
</ul>
<h3>Need Help or Found a Bug?</h3>
<ul>
<li>Support: For one-on-one email support, consider purchasing <a href="https://www.custompermalinks.com/#pricing-section" rel="nofollow ugc">Custom Permalinks Premium</a>. While some basic support may be provided on the WordPress.org forums, email support is prioritized for premium users.</li>
<li>Bug Reports: If you encounter a bug, please report it on <a href="https://github.com/samiahmedsiddiqui/custom-permalinks" rel="nofollow ugc">GitHub</a>. Make sure to provide complete information to reproduce the issue. GitHub is for bug reports, not general support questions.</li>
</ul>
If you experience any site-breaking issues after upgrading, please report them on the <a href="https://wordpress.org/support/plugin/custom-permalinks/" rel="ugc">WordPress Forum</a> or <a href="https://github.com/samiahmedsiddiqui/custom-permalinks" rel="nofollow ugc">GitHub</a> with detailed information. You can always revert to an older version by downloading it from <a href="https://wordpress.org/plugins/custom-permalinks/advanced/" rel="ugc">https://wordpress.org/plugins/custom-permalinks/advanced/</a>.

Custom Permalinks

It works

!!! DO NOT USE THIS PLUGIN !!!

This plugin overwrites Wordpress core functionality and will not work with get_permalink() / get_the_permalink(), it does not update the wp_posts table, but rather creates a manipulation layer that will break these core functions.

Terrible Plugin, Should be on a Disallowed List

Plugin does exactly what it promises to do! Very responsive developer too! Great job.

Great plugin with great support

Broken. No button to add custom post type permalinks.

Broken

It works like charm. But need another plugin to edit the author slug. It would be best if there were author slug edit option.

Great Plugin, But would be best if there were author link edit option


Excellent plugin. I would really like to see categories included as well.


Excellent plugin

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

Permalink Shortcode vs Custom Permalinks