template_redirect │ action-hook │ WP 1.5.0

Fires before determining which template to load.

This action hook executes just before WordPress determines which template page to load. It is a good hook to use if you need to do a redirect with full knowledge of the content that has been queried.

Note: Loading a different template is not a good use of this hook. If you include another template and then use exit() or die(), no subsequent template_redirect will be run, which could break the site’s functionality. Instead, use the template_include filter hook to return the path to the new template you want to use. This will allow an alternative template to be used without interfering with the WordPress loading process.

Usage

add_action( 'template_redirect', 'wp_kama_template_redirect_action' );

/**
 * Function for `template_redirect` action-hook.
 * 
 * @return void
 */
function wp_kama_template_redirect_action(){

	// action...
}

Changelog

Where the hook is called

do_action( 'template_redirect' );

Where the hook is used in WordPress

add_action( 'template_redirect', array( $this, 'handle_render_partials_request' ) );

add_action( 'template_redirect', 'rest_output_link_header', 11, 0 );

add_action( 'template_redirect', 'wp_shortlink_header', 11, 0 );

add_action( 'template_redirect', 'wp_old_slug_redirect' );

add_action( 'template_redirect', 'redirect_canonical' );

add_action( 'template_redirect', 'wp_redirect_admin_locations', 1000 );

add_action( 'template_redirect', '_wp_admin_bar_init', 0 );

add_action( 'template_redirect', 'maybe_redirect_404' );

add_action( 'template_redirect', array( $this, 'render_sitemaps' ) );