WordPress filter hook · part of WordPress core

pre_wp_unique_post_slug

A WordPress core filter that 2 plugins also fire themselves, running on 20+ sites between them.

“Filters the post slug before it is generated to be unique.”

How to use pre_wp_unique_post_slug

It's a filter: your callback receives the value and 5 more arguments, and must return the (changed) value. Add this to your theme's functions.php or a small custom plugin:

functions.php
add_filter( 'pre_wp_unique_post_slug', function( $value, $slug, $post_ID, $post_status, $post_type, $post_parent ) {
	// Change $value here.
	return $value;
}, 10, 6 );

Argument names come from Post ID Optimizer's source. Other plugins may pass different values: check the call in the plugin you're targeting below.

This hook is fired by WordPress core too. Official reference on developer.wordpress.org →

2 plugins that fire pre_wp_unique_post_slug

Sorted by active installs. Each entry shows where the plugin calls the hook and what it passes.

  1. Post ID Optimizer icon Post ID Optimizer10+ installs apply_filters( 'pre_wp_unique_post_slug', null, $slug, $post_ID, $post_status, $post_type, $post_parent ) post-poidopt.php:4150
  2. SlugSync icon SlugSync10+ installs apply_filters( 'pre_wp_unique_post_slug', null, $slug, $post_id, $post_status, $post_type, $post_parent ) slugsync.php:1524

Need a customisation built on this hook?

Tell us what you want to change and which plugin it's for. We'll write it, test it and send it back as a small plugin.