WordPress filter hook · part of WordPress core

wp_link_pages_args

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

How to use wp_link_pages_args

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

functions.php
add_filter( 'wp_link_pages_args', function( $r ) {
	// Change $r here.
	return $r;
}, 10, 1 );

Argument names come from Nekto Core'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 wp_link_pages_args

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

  1. Edit Flow icon Edit Flow4,000+ installs apply_filters( 'wp_link_pages_args', [ 'link_before' => '', 'link_after' => '', 'pagelink' => '%', ] ) modules/custom-status/custom-status.php:2105
  2. Nekto Core icon Nekto Core40+ installs apply_filters( 'wp_link_pages_args', $r ) inc/single_blog-functions.php:256

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.