To set up redirects in WordPress using the .htaccess file, locate the file in your site’s root directory and add redirect rules above the # BEGIN WordPress section. For basic 301 redirects, use the format Redirect 301 /old-page https://example.com/new-page. For pattern-based redirects, enable mod_rewrite and use rewrite rules like redirecting HTTP to HTTPS or changing URL structures. Always back up the file, test changes in a staging environment, avoid caching issues, check for conflicts with plugins, and ensure syntax accuracy to prevent errors.

Setting up redirects in WordPress using the .htaccess file is a straightforward way to manage URL changes, especially when moving content or reorganizing your site. It’s fast, doesn’t require plugins for simple cases, and works at the server level. But it also needs to be done carefully—especially if you're not used to working with server configuration files.

Understanding Where to Add Redirects

The .htaccess file is usually located in the root directory of your WordPress installation. If you're using an FTP client or your hosting control panel (like cPanel), you can find it there. Keep in mind that this file might be hidden by default, so make sure your file browser shows hidden files.

Before making any changes:

• Always back up your .htaccess file.
• Test redirect rules on a staging environment if possible.

You'll want to place your redirect rules above the # BEGIN WordPress section in the file. That way, they won't get overwritten when WordPress updates its internal rewrite rules.

How to Do a Basic 301 Redirect

A 301 redirect tells browsers and search engines that a page has permanently moved to a new location. This is great for SEO because it passes most of the original page's ranking power to the new one.

To redirect an old page to a new one, use this format:

Redirect 301 /old-page https://example.com/new-page

Just replace /old-page with the path of the old URL (relative to your domain) and the full URL of the new destination.

Some common variations:

• Redirecting a whole category:
  Redirect 301 /old-category https://example.com/new-category
• Sending traffic from an outdated post to your homepage:
  Redirect 301 /outdated-post https://example.com/

This method works well for small-scale redirects, but if you have dozens or hundreds, consider using a plugin or more advanced rewrite rules.

Using Rewrite Rules for More Flexibility

Sometimes you need something more flexible than basic Redirect commands—like redirecting all URLs matching a certain pattern. For that, Apache's mod_rewrite engine comes into play.

Here's a common example: redirecting all traffic from HTTP to HTTPS:

RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

Another example: redirecting all requests for old blog URLs like /blog/post-name to /news/post-name:

RewriteEngine On
RewriteCond %{REQUEST_URI} ^/blog/(.*)$
RewriteRule ^blog/(.*)$ /news/$1 [R=301,L]

These rules are more powerful but also trickier. A single typo can break your site, so double-check everything and test after applying.

Common Mistakes and Tips

When editing .htaccess, mistakes happen. Here are a few common pitfalls and how to avoid them:

• Caching issues: After setting up a redirect, clear both your browser cache and any caching plugins or CDN caches to see the change.
• Conflicting rules: If you're using a redirection plugin in WordPress, it may conflict with manual .htaccess rules. Check both places if things aren’t working as expected.
• No syntax highlighting: Editing .htaccess in plain text makes it easy to miss errors. Use a code editor that supports syntax checking.
• Overwriting rules: Make sure your redirect lines don’t get pushed below the WordPress-generated section—you’ll lose them after a permalink update.

If your site breaks after saving changes, restore your backup .htaccess file immediately.

Basically, setting up redirects via .htaccess is pretty straightforward once you understand the basics. Just remember to keep it clean, test often, and always have a backup handy.

The above is the detailed content of How to set up redirects in WordPress htaccess. For more information, please follow other related articles on the PHP Chinese website!