How to redirect users to a different page in WordPress using wp_redirect

The wp_redirect function in WordPress is used to redirect users to a different URL. This can be useful for various purposes such as redirecting users after a form submission, redirecting users to a specific page after login, or redirecting users to a different website altogether.

By using the wp_redirect function, developers can control the flow of user navigation and ensure that users are directed to the appropriate pages or external sites based on certain conditions or actions.

Parameters Accepted by wp_redirect Function

  • $location (string, required): The path or URL to redirect to.
  • $status (int, optional, default value: 302): HTTP response status code to use. Default is ‘302’ (Moved Temporarily).
  • $x_redirect_by (string, optional, default value: ‘WordPress’): The application doing the redirect. Default is ‘WordPress’.

Return Value of wp_redirect Function

The function returns a boolean value. It returns false if the redirect was canceled, and true otherwise.

Examples

How to redirect to a specific URL using wp_redirect

Here’s a code snippet demonstrating how to use the wp_redirect function to redirect to a specific URL:

<?php
$redirect_url = 'https://example.com/new-page';
wp_redirect( $redirect_url );
exit;
?>

This code snippet sets the $redirect_url variable to the desired URL and then uses the wp_redirect function to redirect the user to that URL. The exit function is used to stop the execution of the script after the redirect.

How to redirect to a specific page using wp_redirect

Here’s a code snippet demonstrating how to use the wp_redirect function to redirect to a specific page within the WordPress site:

<?php
$page_id = 15;
$page_url = get_permalink( $page_id );
wp_redirect( $page_url );
exit;
?>

This code snippet uses the get_permalink function to retrieve the URL of the page with the ID 15 and then uses the wp_redirect function to redirect the user to that page. The exit function is used to stop the execution of the script after the redirect.

How to redirect with a 301 status code using wp_redirect

Here’s a code snippet demonstrating how to use the wp_redirect function to redirect with a 301 status code:

<?php
$redirect_url = 'https://example.com/new-page';
wp_redirect( $redirect_url, 301 );
exit;
?>

This code snippet sets the $redirect_url variable to the desired URL and then uses the wp_redirect function with the status code 301 to perform a permanent redirect to that URL. The exit function is used to stop the execution of the script after the redirect.

Conclusion

In conclusion, the wp_redirect function is a valuable utility for redirecting users to a different page or URL within a WordPress website. It provides a simple and efficient way to handle redirections, whether it’s for login/logout actions, form submissions, or custom functionality. By understanding how to properly use this function and being mindful of potential pitfalls such as infinite loops, developers can enhance the user experience and streamline website navigation. With its flexibility and ease of use, wp_redirect is a valuable asset for WordPress developers looking to create a seamless and intuitive browsing experience for their users.

Related WordPress Functions