WordPress filter hook · part of WordPress core

wp_insert_post_parent

A WordPress core filter that 8 plugins also fire themselves, running on 12K+ sites between them.

“This filter is documented in wp-includes/post.php”

How to use wp_insert_post_parent

It's a filter: your callback receives the value and 3 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( 'wp_insert_post_parent', function( $post_parent, $post_id, $new_postarr, $postarr ) {
	// Change $post_parent here.
	return $post_parent;
}, 10, 4 );

Argument names come from ALD'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 →

8 plugins that fire wp_insert_post_parent

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

  1. ALD icon ALD8,000+ installs apply_filters( 'wp_insert_post_parent', $post_parent, $post_id, $new_postarr, $postarr ) includes/ali-product-table.php:347
  2. Seamless Donations is Sunset icon Seamless Donations is Sunset2,000+ installs apply_filters( 'wp_insert_post_parent', $post_parent, $post_ID, $new_postarr, $postarr ) inc/utilities.php:1368
  3. Customize Posts icon Customize Posts1,000+ installs apply_filters( 'wp_insert_post_parent', $post_data['post_parent'], $this->post_id, $post_data, $initial_sanitized_post_data ) php/class-wp-customize-post-setting.php:458
  4. FlexStock icon FlexStock600+ installs apply_filters( 'wp_insert_post_parent', $post_parent, $post_id, $new_postarr, $postarr ) includes/helper/functions.php:1607
  5. TMDS icon TMDS400+ installs apply_filters( 'wp_insert_post_parent', $post_parent, $post_id, $new_postarr, $postarr ) includes/class/tmds-products-table.php:402
  6. ChinaDS icon ChinaDS100+ installs apply_filters( 'wp_insert_post_parent', $post_parent, $post_id, $new_postarr, $postarr ) admin/taobao-products-table.php:400
  7. HANDMADE icon HANDMADE40+ installs apply_filters( 'wp_insert_post_parent', $post_parent, $post_id, $new_postarr, $postarr ) includes/class/handmade-products-table.php:402
  8. Post ID Optimizer icon Post ID Optimizer10+ installs apply_filters( 'wp_insert_post_parent', $post_parent, $post_ID, $new_postarr, $postarr ) post-poidopt.php:3657

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.